Click above to get retro games delivered to your door ever month!

 RESTORE SCREEN*
 Display a saved screen
------------------------------------------------------------------------------
 Syntax

     RESTORE SCREEN [FROM <cScreen>]

 Arguments

     FROM <cScreen> specifies a character expression to display to the
     screen.

 Description

     RESTORE SCREEN is a command synonym for the RESTSCREEN() function that
     redisplays a previously saved screen, and is used with SAVE SCREEN to
     avoid repainting the original screen painted with @...SAY, @...GET, and
     ? commands.

     RESTORE SCREEN works in two ways depending on whether or not you specify
     the FROM clause .  If the you specify the FROM clause, the SCREEN is
     RESTOREd FROM <cScreen>.  <cScreen> is a character expression, usually a
     variable assigned a screen image by SAVE SCREEN.  If you do not specify
     the FROM clause, the SCREEN is RESTOREd from the default save screen
     buffer created by SAVE SCREEN specified without the TO clause.

     SAVESCREEN() and RESTORESCREEN() functions supersede SAVE SCREEN and
     RESTORE SCREEN commands.

     RESTORE SCREEN is a compatibility command and not recommended.

     Warning!  SAVE SCREEN, RESTORE SCREEN, SAVESCREEN(), and
     RESTSCREEN() are supported when using the default (IBM PC memory mapped)
     screen driver.  Other screen drivers may not support saving and
     restoring screens.

 Examples

     .  This example displays a small alert popup box using SAVE and
        RESTORE SCREEN:

        IF FileAlert()
           COPY FILE Them.txt TO My.txt
        ELSE
           BREAK
        ENDIF
        RETURN

        FUNCTION FileAlert
           LOCAL lAnswer := .F., cScreen
           SAVE SCREEN TO cScreen
           @ 10, 10 CLEAR TO 12, 45
           @ 10, 10 TO 12, 45 DOUBLE
           @ 11, 12 SAY "File exists, overwrite? (y/n) ";
                  GET lAnswer PICTURE "Y"
           READ
           RESTORE SCREEN FROM cScreen
           RETURN lAnswer

 Files:  Library is CLIPPER.LIB.