C5_SAVE SCREEN

 SAVE SCREEN*
 Save the current screen to a buffer or variable
------------------------------------------------------------------------------
 Syntax

     SAVE SCREEN [TO <idVar>]

 Arguments

     TO <idVar> specifies a variable to contain the current screen
     contents as a character value.  If <idVar> is not visible or does not
     exist, a private memory variable is created and assigned to the screen.

 Description

     SAVE SCREEN is a command synonym for the SAVESCREEN() function that
     saves the screen from 0, 0 to MAXROW(), MAXCOL() in a default screen
     buffer, or in an optional variable.  If the screen is saved to a
     variable, the variable can be any storage class including field, local,
     static, or an array element.  Note, however, you cannot SAVE an array or
     local or static variable to .mem files to save multiple screens to disk.

     SAVE SCREEN is used with RESTORE SCREEN to eliminate repainting an
     original screen that has been temporarily replaced.  You may save
     multiple screens by assigning each screen to a separate variable.

     SAVE SCREEN is a compatibility command and not recommended.  It is
     superseded by the SAVESCREEN() function which can save partial or full
     screens.

     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 code skeleton uses a static array to store saved screens:

        STATIC aScreens[10]
        SAVE SCREEN TO aScreens[1]
        //
        <statements>...
        //
        RESTORE SCREEN FROM aScreens[1]

     .  This example saves and restores screens using a database file:

     USE Screens INDEX Name NEW
        APPEND BLANK

        Screens->Name := "Screen001"            // Save the screen name
        SAVE SCREEN TO Screens->Image           // Save a new screen image
        //
        <statements>...
        //
        SEEK "Screen001"                        // Find the screen
        RESTORE SCREEN FROM Screens->Image      // Restore it

 Files   Library is CLIPPER.LIB.

See Also: MAXROW() MAXCOL() RESTSCREEN() SAVE SAVESCREEN()

 

Advertisements

3 responses to “C5_SAVE SCREEN

  1. Pingback: C5 UI – Basics | Viva Clipper !

  2. Pingback: C5 User Interface | Viva Clipper !

  3. Pingback: C5 Commands | Viva Clipper !

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.