Difference between revisions of "SET KEY TO"

From Recital Documentation Wiki
Jump to: navigation, search
 
Line 1: Line 1:
=SET KEY...TO=
 
  
 
==Class==
 
Keyboard Events
 
 
 
==Purpose==
 
Define hot keys
 
 
 
==Syntax==
 
SET KEY <expN> TO <procedure name>
 
 
 
==See Also==
 
SET KEY, INKEY(), READKEY(), SET PCKEYS, PROCNAME(), PROCLINE(), READVAR(), PRINTSCREEN()
 
 
 
==Description==
 
The SET KEY...TO command enables a user, running an application, to press a key which will cause execution of the specified procedure whenever the program is waiting for keyboard input.  All keys, excluding a through z and 0 through 9, may be used.
 
 
NOTE: It is important to distinguish this command from the previous command (SET KEY TO <expN>) which has a different purpose.
 
 
On completion of the procedure, execution of the application continues from the point at which it left.  Any valid Recital command can be used in the procedure.  The <expN> is the INKEY() value of the key and <procedure name> is the procedure to be executed when the key is pressed.  The executed procedure specified in the SET KEY...TO command is passed three parameters with the values of PROCNAME(), PROCLINE(), and READVAR() respectively.
 
 
 
==Example==
 
<pre>
 
procedure showlist
 
save screen
 
aliasnam = select()
 
use shows in workarea()
 
display all
 
select &aliasnam
 
restore screen
 
return
 
 
set key 28 to showlist
 
accept "Enter Show Name (F1 for Help)" to event</pre>
 
 
 
==Products==
 
Recital Mirage Server, Recital Terminal Developer
 

Revision as of 14:44, 10 March 2009