Functions and Directives Functions and Directives

Function SetMode() Foundation

Defines the screen mode as a specific number of rows and columns.

Syntax
SetMode( <nMaxRow>, <nMaxCol> ) --> lSuccess
Parameters
<nMaxRow>
<nMaxRow> is a positive integer which indicates the number of rows for a screen mode.
<nMaxCol>
<nMaxCol> is a positive integer specifying the number of columns for a screen mode.
Return

SetMode() returns the value .T. (true) if the screen mode could be set. If the operation fails, .F. (false) is returned.

Description

The screen function SetMode() determines the number of visible rows and columns the screen has. When the rows and columns could be successfully changed, the new values are returned by the functions MaxRow() and MaxCol().

The function SetMode() depends on the operation mode for the Xbase++ application. For a VIO application, only specific values for <nMaxRow> and <nMaxCol> can be specified. These values depend on the available graphic card. Common values are: SetMode(25,80), SetMode(43,80) and SetMode(50,80). For a GUI application, the number of rows and columns specified in a XbpCrt window can be defined.

Examples
SetMode() 
// The example activates the 50 line mode: 

PROCEDURE Main 

   IF .NOT. SetMode( 50, 80 ) 
      ? "50 rows are not supported" 
   ENDIF 

RETURN
Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.