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.

      // 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()