COMMAND KEY() block
The COMMAND KEY(key-name) block (without an option text)
defines a menu action handler with a set of instructions to be executed when an action is
invoked.
The KEY() clause defines one to four accelerator keys separated by a
comma. The specified key name must be one of the
virtual keys.
KEY() clause allows a
comma-separated list of keys. Up to four keys can be specified. For new developments, consider using
a single key, or prefer ON ACTION
handlers with a single accelerator definition in action defaults.While a COMMAND KEY(key-name)
"option-name" (with option text) defines the name of the
action with the option text (converted to lowercase), a COMMAND
KEY(key-name) (without option text), defines the
action name from the last key in the KEY() list, converted to
lowercase letters. For example, with COMMAND KEY(F10,F12,Control-Z),
the name of the action will be "control-z".
Action defaults will be applied by using the key name of the KEY() clause. With
a list of keys, the last key name will be used to apply action defaults, because it defines the
action name.
KEY() clause will take precedence over accelerators defined with action defaults
corresponding to the action name.By default, COMMAND KEY(key-name) actions are not decorated
with a default action (this means that a button in the action frame will not appear for these
actions). However, by defining the TEXT attribute within action defaults, the
default action view button will be visible. This allows you to decorate existing COMMAND
KEY(key-name) clauses with graphical buttons without changing the
program code.
To write abstract code without decoration in your programs, use the ON ACTION clause instead of COMMAND
[KEY], except if the action view must get the focus.
In TUI mode, actions created with COMMAND [KEY] do not get accelerators
from action defaults; Only actions defined with ON ACTION will get accelerators of
action defaults.