KEYTRAP

Top  Previous  Next

 

The KEYTRAP statement defines trap keys for use with INPUT @.

 

 

Format

 

KEYTRAP (action, key), (action, key), ...

 

where

 

actionis a user defined value in the range 1 to 255 to be returned by the STATUS() function following an INPUT @ that is terminated by use of the key defined by key.

A negative action value removes the key binding specified by key.

 

keyidentifies the key to be bound to the given action. This is specified as a numeric value:
1 to 31Use the control key with this character value. Ctrl-A is 1, Ctrl-B is 2, etc.
32 to 159Use the Escape key followed by the key with this character value.
160+Use a sequence of up to four characters constructed from the bytes of (key  160) starting from the low order byte.

 

 

The KEYTRAP statement defines one or more keys that will terminate an INPUT @ statement. When any of these keys in pressed the INPUT @ returns with the original value of the input variable. The STATUS() function will return the value defined by action for the key.

 

See the KEYEXIT statement for a method to return the input data as entered up to the moment when this key was used.

 

 

See also:

BINDKEY(), INPUT@, INPUTFIELD, KEYCODE(), KEYEDIT, KEYEXIT