SAVESCREEN()

Purpose

Function to save a screen region to a memory variable

Syntax

SAVESCREEN(<expN1>,<expN2>,<expN3>,expN4>)

See Also

@...SAY, @...MENU, APPEND, BROWSE, CHANGE, EDIT, MENU, QUERY, RESTSCREEN(), RESTORE SCREEN, SAVE SCREEN, SET SCREENMAP

Description

The SAVESCREEN() function allows you to save a portion of a screen for redisplay later. The coordinates of the screen portion are specified in the numeric expressions <expN1-4> . The numeric expressions represent numbers for the beginning row, beginning column, ending row and ending column, respectively. When SCREENMAP is on, the SAVESCREEN() function allows an image of all or part of the current terminal display to be saved to a memory variable. All Recital output to the screen is stored as part of the screen image. No output from the RUN command is stored.

Example

// Clear area for pop-up window
save_win = savescreen(1,5,10,20)
// Pop up a window
// Restore screen area
restscreen(1,5,10,20,save_win)

Products

Recital