KeyBinding Element

Article
11/15/2016

Note

This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. 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>

Partager via