_gtSetMode()
 Change display mode to a specified number of rows and columns
------------------------------------------------------------------------------
 C Prototype

     #include "gt.api"
     ERRCODE _gtSetMode(
                         USHORT uiRows,
                         USHORT uiCols
                       )

 Arguments

     uiRows is the number of rows in the desired display mode.

     uiCols is the number of columns in the desired display mode.

 Returns

     _gtSetMode() returns zero if successful.  Any other value indicates an
     error.

 Description

     _gtSetMode() attempts to change the mode of the display hardware to
     match the number of rows and columns specified.  The change in screen
     size is reflected in the values returned by _gtMaxRow() and _gtMaxCol().

 Examples

     .  This example displays a message after successfully selecting
        43-line mode:

        #include "gt.api"
        .
        .
        .
           if ( _gtSetMode(43, 80) = 0 )
              _gtWriteAt( 0, 0, "43-line mode set", 16 );
        .
        .
        .

 Files  Library is CLIPPER.LIB, header file is Gt.api.