Configuring a function key to call a ring menu option

on

Configure a function key to call a ring menu option


SYNTAX

on key_no optmenu option_id [, key_no optmenu option_id] [, …]

Configure a function key to select a ring menu option. In addition to the function keys F1 - F32, a number of other special keys may be used (listed below).

The function key is only active while the program is awaiting option selection from a ring menu. Pressing it at other times has no effect. It remains configured until the program terminates, unless reconfigured for some other purpose by another on command, or disabled by means of the clearkey statement.

key_no

The key number is the sequence number of the key in Section 5 (“Sent by” sequences) of the terminal parameter file. The keys which are available for use have mnemonic definitions in $SCULPTOR/include/sculptor.h, and are as follows:

Key no

Definition

1 - 32

F1 - 32

38

HOME

39

ENDKEY

41

TAB

42

BACKTAB

49

INS_LINE

50

DEL_LINE

53

SCRL_UP

54

SCRL_DN

55

PGUP

56

PGDN

Either the key number (which may be an expression) or the mnemonic may be used.

option_id

This must be the option code (one or two characters) of a ring menu style program option.


EXAMPLE

F10 key will terminate program if pressed at option prompt

on F10 optmenu *e
...

*e = "&EXIT"
     exit

RELATED TOPICS

clearkey

Ring menus