Difference between revisions of "SET SCREENMAP"

From Recital Documentation Wiki
Jump to: navigation, search
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=SET SCREENMAP=
 
 
 
==Class==
 
Screen Environment
 
 
 
 
==Purpose==
 
==Purpose==
 
Enable or disable automatic screen map control.
 
Enable or disable automatic screen map control.
Line 15: Line 8:
  
 
==See Also==
 
==See Also==
SAVE SCREEN, RESTORE SCREEN, @...SAY, @...MENU, MENU, SET TBUFSIZE, SET CONSOLE, CHR(), SET MAPCHAR, SET SCREENIO, SET DEVICE, SET PRINTER, SET ALTERNATE
+
[[!]], [[!!]], [[@...SAY]], [[@...MENU]], [[CHR()]], [[MENU]], [[RESTORE SCREEN]], [[RUN]], [[RUN()]], [[SAVE SCREEN]], [[SET ALTERNATE]], [[SET CONSOLE]], [[SET DEVICE]], [[SET MAPCHAR]], [[SET PRINTER]], [[SET SCREENIO]], [[SET SCROLL]], [[SET TBUFSIZE]]
  
  
Line 31: Line 24:
  
 
==Example==
 
==Example==
<pre>
+
<code lang="recital">
 
// Program to illustrate use of SET ALTERNATE commands
 
// Program to illustrate use of SET ALTERNATE commands
 
// ’.txt.’ extension will be assumed
 
// ’.txt.’ extension will be assumed
Line 43: Line 36:
 
set device to print
 
set device to print
 
set alternate on
 
set alternate on
setprc(0,0) && set coordinates to 0,0
+
setprc(0,0)   && set coordinates to 0,0
 
@1,0 say [write this to file to the file, not to the screen]
 
@1,0 say [write this to file to the file, not to the screen]
 
close alternate
 
close alternate
Line 50: Line 43:
 
set device to screen
 
set device to screen
 
return
 
return
// end of program</pre>
+
// end of program
 +
</code>
  
  
 
==Products==
 
==Products==
Recital Terminal Developer
+
Recital  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Commands]]
 
[[Category:Commands]]
[[Category:Set_Commands]]
+
[[Category:Set_Commands|SCREENMAP]]
 +
[[Category:Terminal Environment]]
 +
[[Category:Terminal Environment Set Commands]]

Latest revision as of 15:28, 25 November 2009

Purpose

Enable or disable automatic screen map control.


Syntax

SET SCREENMAP ON | OFF | (<expL>)


See Also

!, !!, @...SAY, @...MENU, CHR(), MENU, RESTORE SCREEN, RUN, RUN(), SAVE SCREEN, SET ALTERNATE, SET CONSOLE, SET DEVICE, SET MAPCHAR, SET PRINTER, SET SCREENIO, SET SCROLL, SET TBUFSIZE


Description

When SCREENMAP is set ON, an internal map is kept of the contents of the terminal screen. Refreshing only those parts of the screen that need updating optimizes all terminal output. For popup menus to be available, and SAVE/RESTORE SCREEN command to work properly, SCREENMAP should be ON. Note also that when SCREENMAP is ON, all system generated forms (as in BROWSE, APPEND, CHANGE, EDIT, QUERY, CREATE) use screen imaging.

It is recommended that SCREENMAP is left ON unless it specifically needs to be turned OFF, because screen displays are more efficient with SCREENMAP ON.

Any output to the screen from the RUN command or displays of parts of the screen with SCROLL, are not mapped. When using the SET SCROLL command, it is recommended that SCREENMAP is turned OFF.

This command allows the optional logical expression <expL> to be evaluated. If a value of .T. is returned, SCREENAMP is set ON. If a value of .F. is returned, SCREENMAP is set OFF.

NOTE: Because of the screen output optimization performed with SCREENMAP ON, output directed to the printer attached to the terminal will not print correctly. In such a case, you should turn SCREENMAP OFF before printing the report, then set SCREENMAP back ON.


Example

// Program to illustrate use of SET ALTERNATE commands
// ’.txt.’ extension will be assumed
set alternate to alt
? [Write this text to file]
set alternate off
? [Don’t write this text to file]
?
set console off
set screenmap off
set device to print
set alternate on
setprc(0,0)    && set coordinates to 0,0
@1,0 say [write this to file to the file, not to the screen]
close alternate
set console on
set screenmap on
set device to screen
return
// end of program


Products

Recital