Skip to content

Update Available Keys for the v8.7.6 ShortcutMapper keyboard improvement #784

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Update Available Keys for the v8.7.6 ShortcutMapper keyboard improvement #784

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion content/docs/preferences.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -776,7 +776,9 @@ _Please Note_: Notepad++ honors standard Windows behavior with keystrokes for me

### Available Keys

In the pulldown for Shortcut Mapper keys, the list of keys mostly matches a standard US keyboard (excepting the `<>` key, which US keyboards don't generally have). It's not actually that _character_ that maps to Shortcut Mapper shortcut, but the underlying keyboard scancode, and how it maps to the Windows Virtual Key. The Community Forum has a [FAQ](https://community.notepad-plus-plus.org/topic/19734/faq-list-of-notepad-key-combinations-available-for-shortcuts) which shows the full "Virtual Key" vs "US key description", showing which are available to the shortcut mapper (and which shortcuts are by default assigned to an action in Notepad++). The FAQ also lists the equivalent keyboard keys for some major keyboards (including French, German, and Portuguese), and provides links to possible external websites that might help you figure out the mapping for your own keyboard.
Starting in v8.7.6, the character pulldown list for Shortcut Mapper keys will list the normal ASCII characters; it should also recognize whatever keyboard was active when you started Notepad++, and for the keys unique to your location (be it US-english or French or Brazillian Portuguese or what have you), it should list any of those keys that are available for mapping in shortcuts. (If you can switch between multiple keyboard configurations in your version of Windows, Notepad++ will use whichever layout was active when Notepad++ was run, so if you want to switch keyboards, you will have to exit Notepad++, switch the keyboard setting, then restart Notepad++.)

Prior to v8.7.6, the character pulldown for Shortcut Mapper keys mostly matched a standard US keyboard (excepting the `<>` key, which US keyboards don't generally have). It's not actually that _character_ that maps to Shortcut Mapper shortcut, but the underlying keyboard scancode, and how it maps to the Windows Virtual Key. The Community Forum has a [FAQ](https://community.notepad-plus-plus.org/topic/19734/faq-list-of-notepad-key-combinations-available-for-shortcuts) which shows the full "Virtual Key" vs "US key description", showing which are available to the shortcut mapper (and which shortcuts are by default assigned to an action in Notepad++). The FAQ also lists the equivalent keyboard keys for some major keyboards (including French, German, and Portuguese), and provides links to possible external websites that might help you figure out the mapping for your own keyboard. (The pre-v8.7.6 was more confusing, because the shortcut listed in Notepad++ shows a different key than you actually have to type on your non-US keyboard; if this confuses you, it is highly recommended to upgrade to a newer Notepad++, so the Shortcut Mapper matches your active keyboard.)

### Configuration file: `shortcuts.xml`

Expand Down