__XSaveScreen()

Save whole screen image and coordinate to an internal buffer

Syntax

__XSaveScreen() --> NIL

Arguments

none.

Returns

__XSaveScreen() always return NIL.

Description

__XSaveScreen() save the image of the whole screen into an internal buffer, it also save current cursor position. The information could later be restored by __XRestScreen(). Each call to __XSaveScreen() 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.

__XSaveScreen() is a compatibility function, it is superseded by SAVESCREEN() which allow you to save part or all the screen into a variable.
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.

Files

Library is rtl

See Also