SAVE.SCREEN()

SAVE.SCREEN()

Top  Previous  Next

 

The SAVE.SCREEN() function saves a rectangular portion of the display screen image.

 

This statement can only be used with QMConsole and QMTerm sessions and with terminals that support the save and restore screen region functions (e.g. AccuTerm 5.2b upwards with terminal definitions that have the -at suffix).

 

 

Format

 

SAVE.SCREEN(col, line, width, height)

 

where

 

colis the screen column (from zero) of the leftmost column to be saved.

 

lineis the screen line (from zero) of the top line to be saved.

 

widthis the width of the screen region to be saved.

 

heightis the height of the screen region to be saved.

 

 

The SAVE.SCREEN() function saves the data and display attributes of the screen image within the specified screen area. The value assigned to the variable set by this function can only be used by the RESTORE.SCREEN statement.

 

 

Example

 

IMAGE = SAVE.SCREEN(0, 0, 80, 25)

EXECUTE COMMAND.STRING

RESTORE.SCREEN IMAGE, @TRUE

 

The above code fragment saves the screen image, executes the command in variable COMMAND.STRING and then restores the screen image.

 

 

See also:

RESTORE.SCREEN