Keymap EditorΒΆ
The Keymap Editor dialog is used to edit the bindings and ancillary settings that make up a keymap.
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.
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.