SAVE SCREEN

SAVE SCREEN

Save whole screen image and coordinate to an internal buffer

Syntax

      SAVE SCREEN

Arguments

none.

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

Compliance

Clipper

Platforms

All(GT)

Seealso

RESTORE SCREEN, __XRestScreen(), __XSaveScreen()

RESTORE SCREEN

RESTORE SCREEN

Restore screen image and coordinate from an internal buffer

Syntax

      RESTORE SCREEN

Arguments

none.

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

Compliance

Clipper

Platforms

All (GT)

Seealso

__XRESTSCREEN(), SAVE SCREEN, __XSAVESCREEN()

__XRestScreen()

Template

Procedure

Name

__XRestScreen()

Category

API

Subcategory

User interface

Oneliner

Restore screen image and coordinate from an internal buffer

Syntax

      __XRestScreen()

Arguments

none.

Description

__XRestScreen() restore saved image of the whole screen from an internal buffer that was saved by __XSaveScreen(), it also restore cursor position. After a call to __XRestScreen() 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.

__XRestScreen() is a compatibility function, it is superseded by RestScreen() which allow you to restore the screen from a variable.

Examples

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

Compliance

Clipper

Platforms

All(GT)

Files

Library is core

Seealso

__XRestScreen(), SAVE SCREEN, __XSaveScreen()