# SETMODE()

Change the video mode to a specified number of rows and columns

Syntax

  SETMODE( <nRows>, <nCols> ) --> lSuccess

Arguments

  <nRows> is the number of rows for the video mode to set.
  <nCols> is the number of columns for the video mode to set.

Returns

  SETMODE() returns true if the video mode change was successful; otherwise, it returns false.

Description

  SETMODE() is a function that change the video mode depend on the video card and monitor combination, to match the number of rows and columns specified. Note that there are only a real few combination or rows/cols pairs that produce the video mode change. The followings are availables for D.O.S:

12 rows x 40 columns | 12 rows x 80 columns
25 rows x 40 columns | 25 rows x 80 columns
28 rows x 40 columns | 28 rows x 80 columns
50 rows x 40 columns | 43 rows x 80 columns
| 50 rows x 80 columns

  The follow modes are avaliable to Windows

25 rows x 40 columns | 25 rows x 80 columns
50 rows x 40 columns | 43 rows x 80 columns
| 50 rows x 80 columns

  Some modes only are availables for color and/or VGA monitors. Any change produced on the screen size is updated in the values returned by MAXROW() and MAXCOL().

Examples

       þ  The first example change to a 12 lines of display mode:
          IF SETMODE( 12, 40)
             ? "Hey man are you blind ?"
          ELSE
             ? "Mom bring me my glasses!"
          ENDIF

       þ  Next example change to a 50 lines mode:
          IF SETMODE( 50, 80)
             ? "This wonderful mode was successfully set"
          ELSE
             ? "Wait. this monitor are not made in rubber !"
          ENDIF

Status

  Ready

Compliance

  Some of these modes are not availables on Clipper

Platforms

  DOS,WIN32

Files

  Source is gtdos.c,gtwin.c

See Also

- MAXCOL()
- MAXROW()