Key Equivalents

Index of All Documentation » Wing Pro Reference Manual » Customization » Keyboard Personalities »

The command a key will invoke may be modified by specifying a custom key binding. A custom key binding will override any binding for a particular key found in the keymap. Custom key bindings are set via the Custom Key Bindings preference.

To add a binding, click the insert button, then press the key to be bound in the Key field, and enter the name of the command to invoke in the Command field. Commands are documented in the Command Reference.

Key bindings may consist of multiple key strokes in a row, such as Ctrl-X Ctrl-U or Esc X Y Z. Also, multiple modifiers may be pressed. Ctrl-Shift-X is distinct from Ctrl-X.

If multiple comma-separated commands are specified, the key binding will execute the first available command in the listed. For example, specifying debug-restart, debug-continue as the command will first try to restart an existing debug session, and if no debug session exists it will start a new one.

To disable a key binding, leave the command field blank.

Some commands take arguments, which can be specified in the binding, for example by using show-panel(panel_type="debug-probe") or enclose(start="(", end=")")``in the ``Command field. Any unspecified arguments that do not have a default defined by the command will be collected from the user, either in a dialog or in the data entry area at the bottom of the IDE window.

Key bindings defined by default or overridden by this preference will be shown in any menu items that implement the same command. In cases where a command is given more than one key equivalent, only the last equivalent found will be displayed (although both bindings will work from the keyboard).

The Alt Key on OS X

On OS X, the Alt Key preference allows selecting one or both of the Option keys or the Command keys to act as the Alt key modifier for keyboard bindings.

This preference should be set by the user according to keyboard type, so that key bindings in Wing do not prevent entering characters with one or both of the Option keys.

For example, on German keyboards, [, ], and other common symbols are entered with the Option key. In those cases, setting the preference to "Left Option key" frees up the right Option key for entering characters and dedicates the left Option key to triggering key bindings.

When Command is used for Alt, the binding for Alt-<key> takes precedence over any binding for Command-<key> for the same key.