CONSOLE SET VIRTUAL statement 

Purpose

Change the size of the buffers associated with the console window.

Syntax

CONSOLE SET VIRTUAL ncRows&, ncColumns&

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.

When you execute CONSOLE SET VIRTUAL, the size of the console screen buffer for each active page is changed to the rows and columns specified. Each dimension must be larger or equal to the corresponding dimension of the current CONSOLE SET SCREEN size.

Once the console buffer size has been altered, the new size can be retrieved using the CONSOLE GET VIRTUAL statement.

If CONSOLE SET VIRTUAL cannot be successfully executed, an error 5 (Illegal Function Call) is generated.  This would most likely be caused by one or more parameters which are too large for available memory, or smaller than the visible console screen size.

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 VIEW, DESKTOP GET CLIENT, DESKTOP GET LOC, DESKTOP GET SIZE