Adobe FrameMaker 7.0 User Manual page 30

ADOBE FRAMEMAKER 7.0 28
Changing Menus and Commands
You can add a key sequence for any command, even if it also has a mnemonic shortcut.
Adding key sequences
You add a key sequence for a command with a KeySequence statement. This statement can be included within
the command definition statement or in a Modify statement:
<Modify CommandID < KeySequence Sequence>>
The keys in the sequence can be any key on the keyboard. Most keys are represented in the sequence simply by
their character. You represent some keys in the key sequence in a special way. You use symbols for modifier
keys—for example, + for Shift, ^ for Control, and ~ for Alt. The Esc key is used quite often and has a special
abbreviation of a backslash followed by an exclamation point: \!
You can add the shortcut Control-a Control-c for the Copy command with this statement:
<Modify Copy <KeySequence ^a^c>>
If you want to use these special characters as actual characters in a key sequence, you precede them with a
backslash (\). For instance, a + in a key sequence means the Shift key, while a \+ means the plus key. A key
sequence of \!\+c means the Esc key, followed by the + key, followed by the c key. A key sequence of \!+c means
the Esc key, followed by the Shift and the c keys.
You represent other special keys with keysyms. A keysym is a keyword that denotes a special key on the
keyboard. Keysyms are always preceded by a forward slash (/). Valid keysyms are Up, Down, Left, Right, Home,
End, PgUp, PgDn, Return, Tab, BkSp, Space, Delete, Insert, F1 through F16, and Escape. For instance, to include
the Tab key as part of a key sequence, you use /Tab.
You might also want the new shortcut to appear on the menu next to the command label, as a reminder to the
user. You do this with a KeySeqLabel statement. The following statement adds a useful reminder for the Copy
shortcut:
<Modify Copy <KeySeqLabel Ctrl+a Ctrl+c>>
If a command does not have a KeySeqLabel statement, the command will be displayed on the menu with no
shortcut. This does not mean the shortcut does not exist; it just means the shortcut is not displayed on the
menu.
A command can have more than one shortcut. Adding a shortcut for a command or changing the shortcut label
that appears on a menu doesn't disable other shortcuts for a command. As long as a unique shortcut is defined
in a configuration or menu customization file, it will work.
If you set ConfigWarnKbdRedundant to On in the product initialization file (see "Menu preferences" on page 7),
you will see warning messages when you load a customization file that contains shortcut definitions for commands
that already have shortcuts defined for them. The warning messages appear in the console window.
To change the label that appears for a shortcut on a menu without changing the shortcut itself, use the
following statement:
<Modify CommandID <KeySeqLabel Label>>
Label is the label you want to appear next to the command on a menu. The label changes everywhere the
command appears on a menu.
Removing shortcuts for a command
To remove a mnemonic shortcut for a command, remove the ampersand character in the Label statement for
the command.
Online manual