# 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.

Examples

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