Difference between revisions of "SET KEY"
Yvonnemilne (Talk | contribs) (→See Also) |
Yvonnemilne (Talk | contribs) |
||
| Line 15: | Line 15: | ||
==See Also== | ==See Also== | ||
| − | + | [[INKEY()]], [[PRINTSCREEN()]], [[PROCNAME()]], [[PROCLINE()]], [[READKEY()]], [[READVAR()]], [[SET KEY TO]], [[SET PCKEYS]] | |
==Description== | ==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. | 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 | + | NOTE: It is important to distinguish this command from [[SET KEY TO|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 | + | 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 command is passed three parameters with the values of PROCNAME(), PROCLINE(), and READVAR() respectively. |
==Example== | ==Example== | ||
| − | < | + | <code lang="recital"> |
procedure showlist | procedure showlist | ||
save screen | save screen | ||
| Line 37: | Line 37: | ||
set key 28 to showlist | set key 28 to showlist | ||
| − | accept "Enter Show Name (F1 for Help)" to event</ | + | accept "Enter Show Name (F1 for Help)" to event</code> |
Revision as of 09:53, 16 April 2009
Contents
SET KEY
Class
Keyboard Events
Purpose
Define hot keys
Syntax
SET KEY <expN> TO <procedure name>
See Also
INKEY(), PRINTSCREEN(), PROCNAME(), PROCLINE(), READKEY(), READVAR(), SET KEY TO, SET PCKEYS
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 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 command is passed three parameters with the values of PROCNAME(), PROCLINE(), and READVAR() respectively.
Example
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
Products
Recital Mirage Server, Recital Terminal Developer
