Keymap EditorΒΆ

The Keymap Editor dialog is used to edit the bindings and ancillary settings that make up a keymap.

Picture of Keymap Editor dialog.

Example Keymap Editor dialog.

The dialog has the following elements:

Main Tree View
The keymap's bindings. Second-level bindings are shown as children of their associated digraph opener binding.
Search
Enter a search string to filter the table. The search string will be matched against the key/button, modifiers, additional conditions, action type, and action value of each binding in case-insensitive mode.
Enter Key or Button
Focus the input field and enter a keystroke or extended mouse button press. Only bindings matching the key or button will be shown in the table.
Clear Search
Removes any search or key/button filtering and displays all bindings in the table.
Key/Button
The name of the key or extended mouse button associated with the binding.
Priority
The priority of each binding within its key/button group. The lower the number, the higher the priority. When processing a keystroke or button press event, bindings are matched against in ascending order by priority.
Modifiers
Each binding's modifier key conditions, if any.
Additional Conditions
Each binding's conditions other than modifier keys, if any.
Action Type
Each binding's type: literal, action, or digraph.
Action Value
For literal bindings, the string to write to the terminal enclosed in double quotes. For action bindings, the action to invoke.
New Rule
Creates a new toplevel binding and opens it in the Binding Editor dialog (described below).
New Child Rule
Creates a new second-level binding as a child of the selected digraph opener binding and opens it in the Binding Editor dialog (described below).
Delete Rule
Removes the selected binding. If the selected binding is a digraph opener, all of its children will also be removed.
Edit Rule
Opens the selected binding in the Binding Editor dialog (described below).
Move to Top
Moves the selected binding to the top of its key/button group, giving it a priority of 1.
Move Up
Moves the selected binding up within its key/button group.
Move Down
Moves the selected binding down within its key/button group.
Move to Bottom
Moves the selected binding to the bottom of its key/button group.
Keymap Options

Opens a dialog box to edit the keymap's description and options.

Note

To change a keymap's inheritance, use the Rename Keymap button in the Manage Keymaps window.

Apply
Saves changes made in the dialog.
Reset
Discards changes made in the dialog.
Restore Defaults
Erases all bindings and inserts the compiled-in default bindings. This does not change the keymap's description, options, or inheritance.

The Binding Editor dialog is used to create and edit individual bindings.

Picture of Binding Editor dialog.

Example Binding Editor dialog.

The dialog has the following elements:

Conditions
The binding's conditions. Click the requirement column to edit. The possible requirements for each condition are positive, negative, or unspecified (always match).
Key or Button
Select a key/button from the dropdown list or focus the input field and enter a keystroke or extended mouse button press.
Outcome
Specify the binding's type and outcome. For an action binding, select the action to invoke or type an action string into the combo box. For a literal binding, specify a literal string enclosed in double quotes. The backslash escapes that can be used in the literal string are described here.