KeyBinding Element

Note

This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, use the version selector at the top left. We recommend upgrading to Visual Studio 2019. Download it here

The KeyBinding element specifies keyboard shortcuts for the commands.

Commands can have both single and dual key bindings associated with them. An example of a single key binding is CTRL+S for the Save command. Dual key bindings require two successive key combinations to trigger a command. An example of a dual key binding is CTRL+K,CTRL+K to set a bookmark.

Syntax

<Keybinding guid="MyGuid" id="MyId" Editor="MyEditor" key1="B" key2="x" mod1="Control" mod2="Alt" />  

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description
guid Required.
id Required.
editor Required. The editor GUID indicates the editing context for which this keyboard shortcut will be active. The global binding scope value is "guidVSStd97".
key1 Required. Valid values include all typable alphanumerics, and also two-digit hexadecimal values preceded by 0x and VK_constants.
mod1 Optional. Any combination of CTRL, ALT, and SHIFT separated by space.
key2 Optional. Valid values include all typable alphanumerics, and also two-digit hexadecimal values preceded by 0x and VK_constants.
mod2 Optional. Any combination of CTRL, ALT, and SHIFT separated by space.
emulator Optional.
Condition Optional. See Conditional Attributes.

Child Elements

Element Description
Parent
Annotation

Parent Elements

Element Description
KeyBindings Element Groups KeyBinding elements and other KeyBindings groupings.

Example

<KeyBindings>  
  <KeyBinding guid="guidWidgetPackage" id="cmdidUpdateWidget"   
    editor="guidWidgetEditor" key1="VK_F5"/>  
  <KeyBinding guid="guidWidgetPackage" id="cmdidRunWidget"   
    editor="guidWidgetEditor" key1="VK_F5" mod1="Control"/>  
</KeyBindings>  

See Also

KeyBindings Element
Visual Studio Command Table (.Vsct) Files