# SAVE SCREEN

Save whole screen image and coordinate to an internal buffer

Syntax

  SAVE SCREEN

Arguments

  none.

Returns

  SAVE SCREEN always return NIL.

Description

  SAVE SCREEN save the image of the whole screen into an internal buffer, it also save current cursor position. The information could later be restored by REST SCREEN. Each call to SAVE SCREEN overwrite the internal buffer.
  SAVE SCREEN command is preprocessed into __XSaveScreen() function during compile time. Note that SAVE SCREEN TO is preprocessed into SAVESCREEN() function.

Examples

          // save the screen, display list of files than restore the screen
          SAVE SCREEN
          DIR *.*
          WAIT
          RESTORE SCREEN

Status

  Ready

Compliance

  __XSaveScreen() works exactly like CA-Clipper's __XSaveScreen()

Platforms

  __XSaveScreen() is part of the GT API, and supported only by some platforms.

See Also

- RESTORE SCREEN
- __XRESTSCREEN()
- __XSAVESCREEN()