CONSOLE SET VIEW statement

Purpose

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

Syntax

CONSOLE SET VIEW nRow&, nColumn&

Remarks

PowerBASIC allows you to specify a virtual console screen that may, optionally, be larger than the visible 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).  You may change the upper left corner of the view port within the virtual screen with CONSOLE SET VIEW.  If you specify a position which is outside the limits of the virtual screen, PowerBASIC will select a location at the maximum limit in that direction.

The CONSOLE SET VIEW statement affects only the visible console page, regardless of whether it is also the active page.  You can retrieve the current VIEW position with the CONSOLE GET VIEW statement.

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).

Restrictions

This statement was designed for use with the WinNT family of operating systems (WinNT, Win2000, WinXP).  It may not be possible to use all the features under Win95/98/ME, due to faults in the Windows subsystems. At a minimum, under Win95/98/ME, you must disable FONT AUTO-SIZE, and choose a specific fixed font for the console. Then test the features you wish to use, to verify accurate execution.

See also

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