# Shortcut Mapper

The Shortcut Mapper controls the keyboard shortcuts assigned to commands from the menus and the Scintilla control. Pressing such a shortcut will trigger the command. Menu shortcuts have a one-to-one mapping, meaning that a menu item can have only one shortcut, and no duplicate shortcuts are allowed (you can enter them, but only one will work, so be careful with conflicts). Scintilla shortcuts have a one-to-many mapping, meaning a single Scintilla command can be triggered by multiple shortcut combinations. However, the same shortcut for multiple commands is not allowed, just as with the menu.

Shortcuts are listed in a two column list. The left column shows the name of the command, the right column the associated shortcut, if any. When viewing shortcuts, doubleclicking on it or rightclicking and selecting Modify allows you to change it. You will get an dialog with the name (modifiable for macros and run commands) and the assigned shortcut. Use the checkboxes to control what modifier keys to use (note that Scintilla does not support the Windows key, as it hardly makes sense on a Unix/Mac machine) and the dropdownlist to choose the key to press. Selecting 'none' from the list will disable the shortcut key (a warning will appear). Pressing OK applies any changes, Cancel or closing the dialog aborts.

Changing or deleting a shortcut can be done using the Modify or Delete respectively: they act exactly like their right click counterparts.

The dialog for Scintilla shortcuts is a bit different because you can add multiple shortcuts. In addition to the normal controls, you will find a listbox with all the assigned shortcuts (if any). The Add button will add the current entered shortcut if not 'None' and not already in the list. The Remove button will remove the selected shortcut from the list (you can remove all but the last).

The Apply button will change the currently selected shortcut to the current settings. To remove a shortcut if more than one is present, use the Remove button. To remove a shortcut if it is the only one, set it to 'None' and Apply

The OK button will save any added or changed shortcuts, but you have to specifically perform the change before it is saved. <p>In all cases, if a shortcut is determined to be invalid, you cannot press OK or Apply to add or modify the shortcut.

The shortcuts are divided in multiple categories:

Main Menu:
  These shortcuts control the default main menu commands. Additionally you can change the shortcut for switching between documents, but this is not recommended (there are still issues with this if you use some other modifier than the Ctrl key).
Macros:
  Shortcuts for recorded and saved macros. You can edit the name of the macro as well. You can also delete Macros from here by rightclicking on the macro and selecting delete.
Run commands:
  Shortcuts for saved commands. You can edit the name of the command as well. You can also delete Run commands from here by rightclicking on the command and selecting delete.
Plugin commands:
  Shortcuts for plugins. By default a plugin can opt for a shortcut combination but you can manually add or override it here. See also Plugins
Scintilla commands:
  Shortcuts for Scintilla. Only the primary shortcut is displayed in the list, but when editing the command all of them will be listed.