Difference between revisions of "SAVESCREEN()"

From Recital Documentation Wiki
Jump to: navigation, search
 
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=SAVESCREEN()=
 
 
 
==Class==
 
Screen Forms
 
 
 
 
==Purpose==
 
==Purpose==
 
Function to save a screen region to a memory variable
 
Function to save a screen region to a memory variable
Line 15: Line 8:
  
 
==See Also==
 
==See Also==
[[SET SCREENMAP]], [[RESTSCREEN()]], [[CHANGE]], [[EDIT]], [[QUERY]], [[APPEND]], [[BROWSE]], [[@...SAY]], [[@...MENU]], [[MENU]], [[SAVE SCREEN]], [[RESTORE SCREEN]]
+
[[@...SAY]], [[@...MENU]], [[APPEND]], [[BROWSE]], [[CHANGE]], [[EDIT]], [[MENU]], [[QUERY]], [[RESTSCREEN()]], [[RESTORE SCREEN]], [[SAVE SCREEN]], [[SET SCREENMAP]]
  
  
Line 33: Line 26:
  
 
==Products==
 
==Products==
Recital Mirage Server, Recital Terminal Developer
+
Recital  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 +
[[Category:Screen Forms]]
 +
[[Category:Screen Forms Functions]]

Latest revision as of 15:30, 7 December 2009

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