[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
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()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson