Bind keyboard shortcuts to menu items
Applies to: Visual Studio Visual Studio for Mac
To bind a keyboard shortcut to a custom menu command, just add an entry to the .vsct file for the package. This topic explains how to map a keyboard shortcut to a custom button, menu item, or toolbar command, and how to apply the keyboard mapping in the default editor or limit it to a custom editor.
To assign keyboard shortcuts to existing Visual Studio menu items, see Identify and customize keyboard shortcuts.
Choose a key combination
Many keyboard shortcuts are already used in Visual Studio. You should not assign the same shortcut to more than one command because duplicate bindings are hard to detect and may also cause unpredictable results. Therefore, it is a good idea to verify the availability of a shortcut before you assign it.
To verify the availability of a keyboard shortcut
In the Tools > Options > Environment window, select Keyboard.
Make sure that Use new shortcut in is set to Global.
In the Press shortcut keys box, type the keyboard shortcut that you want to use.
If the shortcut is already used in Visual Studio, the Shortcut currently used by box will show the command that the shortcut currently calls.
Try different combinations of keys until you find one that is not mapped.
Keyboard shortcuts that use Alt may open a menu and not directly execute a command. Therefore, the Shortcut currently used by box may be blank when you type a shortcut that includes Alt. You can verify that the shortcut does not open a menu by closing the Options dialog box and then pressing the keys.
The following procedure assumes that you have an existing VSPackage with a menu command. If you need help doing that, take a look at Create an extension with a menu command.
To assign a keyboard shortcut to a command
Open the .vsct file for your package.
Create an empty
<KeyBindings>section after the
<Commands>if it is not already present.
For more information about key bindings, see Keybinding.
<KeyBindings>section, create a
idattributes to those of the command you want to invoke.
mod1attribute to Control, Alt, or Shift.
The KeyBindings section should look something like this:
<KeyBindings> <KeyBinding guid="<name of command set>" id="<name of command id>" editor="guidVSStd97" key1="1" mod1="CONTROL"/> </KeyBindings>
If your keyboard shortcut requires more than two keys, set the
In most situations, Shift should not be used without a second modifier because pressing it already causes most alphanumeric keys to type an uppercase letter or a symbol.
Virtual-key codes let you access special keys that do not have a character associated with them, for example, function keys and the Backspace key. For more information, see Virtual-key codes.
To make the command available in the Visual Studio editor, set the
To make the command available only in a custom editor, set the
editorattribute to the name of the custom editor that was generated by the Visual Studio Package Template when you created the VSPackage that includes the custom editor. To find the name value, look in the
<Symbols>section for a
nameattribute ends in "
editorfactory." This is the name of the custom editor.
This example binds the keyboard shortcut Ctrl+Alt+C to a command named
cmdidMyCommand in a package named
<CommandTable> . . . <Commands> . . . </Commands> <KeyBindings> <KeyBinding guid="guidMyPackageCmdSet" id="cmdidMyCommand" key1="C" mod1="CONTROL" mod2="ALT" editor="guidVSStd97" /> </KeyBindings> . . . </CommandTable>
This example binds the keyboard shortcut Ctrl+B to a command named
cmdidBold in a project named
TestEditor. The command is available only in the custom editor and not in other editors.
<KeyBinding guid="guidVSStd97" id="cmdidBold" editor="guidTestEditorEditorFactory" key1="B" mod1="Control" />