CONSOLE GET VIEW statement

Purpose

Retrieve the position of the viewable part of a virtual screen.

Syntax

CONSOLE GET VIEW TO nRow&, nColumn&

Remarks

PowerBASIC allows you to specify a virtual console screen that may, optionally, be larger than the visible part of the console.  If you create a virtual screen with CONSOLE SET VIRTUAL, scroll bars are automatically added to the visible screen to allow the user to examine the entire screen buffer.

If you create a virtual screen that is larger than the visible screen, PowerBASIC initially positions the viewable part at the upper left corner (position 1,1).  The viewable part can be moved to various parts of the virtual screen by the user (with console scroll bars), or by the programmer (with the CONSOLE SET VIEW statement).

CONSOLE GET VIEW retrieves the view position of the visible page, regardless of whether it is also the active page.

Most PowerBASIC statements specify graphic and pixel positions as x,y (the horizontal term first, then the vertical term).  However, for compatibility with most current and prior versions of BASIC (PowerBASIC included), the statements which reference console rows and columns name the vertical term first (rows, columns).

See also

CONSOLE GET LOC, CONSOLE GET SCREEN, CONSOLE GET SIZE, CONSOLE GET VIRTUAL, CONSOLE SET LOC, CONSOLE SET SCREEN, CONSOLE SET VIEW, CONSOLE SET VIRTUAL