RESTORE SCREEN

Restore screen image and coordinate from an internal buffer

Syntax

RESTORE SCREEN

Arguments

none.

Returns

REST SCREEN always return NIL.

Description

Rest Screen restore saved image of the whole screen from an internal buffer that was saved by Save Screen, it also restore cursor position. After a call to Rest Screen the internal buffer is cleared.

RESTORE SCREEN command is preprocessed into __XRestScreen() function during compile time. Note that RESTORE SCREEN FROM is preprocessed into RESTSCREEN() function.

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

Status

Ready

Compliance

Rest Screen() works exactly like CA-Clipper's Rest Screen

Platforms

Rest Screen is part of the GT API, and supported only by some platforms.

See Also

• __XRESTSCREEN()
• SAVE SCREEN
• __XSAVESCREEN()