Skip to main content
Version: 11.0.x

Keyboard and Hotkeys

Various Controls that implement ICommandSource have a HotKey property that you can set or bind to. Pressing the hotkey will execute the command bound to the Control.

<MenuItem Header="_File">
<MenuItem x:Name="SaveMenuItem" Header="_Save" Command="{Binding SaveCommand}" HotKey="Ctrl+S"/>

You can also use the static methods of the HotKeyManager class to set and get hotkeys from code:

HotKeyManager.SetHotKey(saveMenuItem, new KeyGesture(Key.S, KeyModifiers.Control));

Keys and Modifiers

A Hotkey must have one Key and zero or more KeyModifiers. When setting a Hotkey in XAML using the HotKey property, the string will be parsed as a KeyGesture. Enum.Parse is used to parse the key and modifiers but synonyms like Ctrl instead of Control or Win instead of Meta can be used.

Assign number keys to hotkeys

  • A Hotkey must be use D1..D0 or NumPad1..NumPad0. see: Key
  • By binding the same command to two buttons and hiding one button, you can differentiate between a single number on the numpad and a simple Ctrl+number key.
  • If you want to limit command malfunctions caused by pressing numbers on the numpad, you can also use KeyModifiers.
<!--  It's worked fine  -->
<!-- e.g. Ctrl+1 -->
Command="{Binding CommandX}"
HotKey="Ctrl+D1" />
<!-- e.g. You can also use Alt+NumPad1 -->
Command="{Binding CommandX}"
IsVisible="False" />

<!-- These didn't work -->
<!-- Button.KeyBindings -->
<Button Command="{Binding CommandX}" Content="X">
<KeyBinding Gesture="Ctrl+1" />
<!-- Alt+Number -->
<Button Command="{Binding CommandX}" Content="_1" />


Source code