Привязка сочетаний клавиш к пунктам меню Bind keyboard shortcuts to menu items

Чтобы привязать сочетание клавиш к команде пользовательского меню, просто добавьте запись в файл . vsct для пакета. 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.

Сведения о назначении сочетаний клавиш для существующих элементов меню Visual Studio см. в разделе Обнаружение и настройкасочетаний клавиш. To assign keyboard shortcuts to existing Visual Studio menu items, see Identify and customize keyboard shortcuts.

Выбор сочетания клавиш Choose a key combination

Многие сочетания клавиш уже используются в Visual Studio. 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.

Убедитесь, что для параметра использовать новый ярлык в выбрано значение Global. 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.

Если сочетание клавиш уже используется в Visual Studio, в диалоговом окне сочетание клавиш в настоящий момент будет отображаться команда, которая в данный момент вызывается. 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.

Сочетания клавиш, использующие ALT , могут открывать меню, а не выполнять команду напрямую. Keyboard shortcuts that use Alt may open a menu and not directly execute a command. Таким образом, сочетание клавиш, используемое в настоящий момент в поле, может быть пустым при вводе ярлыка, включающего ALT. Можно проверить, что ярлык не открывает меню, закрыв диалоговое окно Параметры и нажав клавиши. 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.

В следующей процедуре предполагается наличие существующего пакета VSPackage с командой меню. 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

Откройте файл . vsct для пакета. Open the .vsct file for your package.

Создайте пустой раздел после, если он еще не существует. Create an empty section after the if it is not already present.

Дополнительные сведения о привязках ключей см. в разделе настраиваемое сочетание клавиш. For more information about key bindings, see Keybinding.

В разделе Создайте запись. In the section, create a entry.

Задайте guid атрибуты и id для тех элементов команды, которую требуется вызвать. Set the guid and id attributes to those of the command you want to invoke.

Присвойте mod1 атрибуту значение Control, ALT или SHIFT. Set the mod1 attribute to Control, Alt, or Shift.

Раздел сочетания клавиш должен выглядеть примерно так: The KeyBindings section should look something like this:

Если для сочетания клавиш требуется более двух ключей, задайте mod2 key2 атрибуты и. If your keyboard shortcut requires more than two keys, set the mod2 and key2 attributes.

В большинстве случаев SHIFT не следует использовать без второго модификатора, так как при нажатии на него наиболее буквенно-цифровой ключ вводится прописная буква или символ. 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.

С помощью кодов виртуальных клавиш можно получить доступ к специальным ключам, которые не содержат связанных с ними символов, например, функциональных клавиш и клавиши Backspace . 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.

Чтобы сделать команду доступной в редакторе Visual Studio, присвойте editor атрибуту значение guidVSStd97 . To make the command available in the Visual Studio editor, set the editor attribute to guidVSStd97 .

Чтобы команда стала доступной только в пользовательском редакторе, присвойте editor атрибуту имя пользовательского редактора, созданного Visual Studio Visual Studio шаблоном пакета при создании VSPackage, включающего пользовательский редактор. To make the command available only in a custom editor, set the editor attribute to the name of the custom editor that was generated by the Visual Studio Visual Studio Package Template when you created the VSPackage that includes the custom editor. Чтобы найти значение имени, просмотрите раздел для узла, name атрибут которого заканчивается на » editorfactory .» Это имя пользовательского редактора. To find the name value, look in the section for a node whose name attribute ends in » editorfactory .» This is the name of the custom editor.

Пример 1 Example 1

В этом примере сочетание клавиш CTRL + ALT + C привязывается к команде cmdidMyCommand в пакете с именем MyPackage . This example binds the keyboard shortcut Ctrl+Alt+C to a command named cmdidMyCommand in a package named MyPackage .

Пример 2 Example 2

В этом примере сочетание клавиш CTRL + B привязывается к команде cmdidBold в проекте с именем TestEditor . 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.

Определение и настройка сочетаний клавиш в Visual Studio Identify and customize keyboard shortcuts in Visual Studio

Вы можете определить сочетания клавиш для команд Visual Studio, настроить эти сочетания клавиш и экспортировать их для других пользователей. You can identify keyboard shortcuts for Visual Studio commands, customize those shortcuts, and export them for others to use. Многие сочетания клавиш всегда вызывают одни и те же команды, в то время как поведение других сочетаний клавиш может быть различным в зависимости от следующих условий: Many shortcuts always invoke the same commands, but the behavior of a shortcut can vary based on the following conditions:

параметры среды по умолчанию, которые были выбраны при первом открытии Visual Studio (например, «Обычные параметры среды разработки» или «Visual C#»). Which default environment settings you choose the first time that you open Visual Studio—for example, General Development or Visual C#. (Дополнительные сведения об изменении или сбросе параметров см. в этой статье.); (For information about changing or resetting your settings, see Environment settings.)

настраивались ли сочетания клавиш пользователем; Whether you’ve customized the shortcut’s behavior.

контекст в момент нажатия сочетания клавиш. Which context you’re in when you choose the shortcut. Например, клавиша F2 вызывает команду Edit.EditCell при использовании конструктора параметров или команду File.Rename при использовании Team Explorer. For example, the F2 shortcut invokes the Edit.EditCell command if you’re using the Settings Designer and it invokes the File.Rename command if you’re using Team Explorer.

Независимо от настроенных параметров и контекста сочетания клавиш можно всегда найти и изменить в диалоговом окне Параметры. Regardless of settings, customization, and context, you can always find and change a keyboard shortcut in the Options dialog box. Вы можете также просмотреть сочетания клавиш по умолчанию для нескольких десятков команд в статье популярные сочетания клавиш. You can also look up the default keyboard shortcuts for several dozen commands in Popular keyboard shortcuts. Полный список сочетаний клавиш по умолчанию (для режима Обычные параметры среды разработки) собран в этой статье. For a complete list of all default shortcuts (based on the General Development settings), see All keyboard shortcuts.

Если сочетание клавиш назначено команде только в глобальном контексте, но не в других контекстах, это сочетание будет всегда вызвать данную команду. If a shortcut is assigned to a command in the Global context and no other contexts, that shortcut will always invoke that command. Однако сочетание клавиш можно назначить одной команде в глобальном контексте и другой команде в более узком контексте. But a shortcut can be assigned to one command in the Global context and a different command in a specific context. При использовании такого сочетания клавиш в конкретном контексте вызывается команда для данного контекста, а не для глобального контекста. If you use such a shortcut when you’re in the specific context, the shortcut invokes the command for the specific context, not the Global context.

Имена и расположение команд меню и параметров в диалоговых окнах могут зависеть от пользовательских настроек и выпуска Visual Studio. Your settings and edition of Visual Studio might change the names and locations of menu commands and the options that appear in dialog boxes. Эта страница основана на профиле параметров Обычные параметры разработки. This page is based on the General Development settings profile.

Определение сочетания клавиш Identify a keyboard shortcut

В строке меню выберите Сервис > Параметры. On the menu bar, choose Tools > Options.

Разверните пункт Среда и выберите элемент Клавиатура. Expand Environment, and then choose Keyboard.

В поле Показать команды, содержащие введите полное имя команды без пробелов или его часть. In the Show commands containing box, enter all or part of the name of the command without spaces.

Например, можно найти команды для solutionexplorer . For example, you can find commands for solutionexplorer .

В списке выберите нужную команду. In the list, choose the correct command.

Например, можно выбрать View.SolutionExplorer . For example, you can choose View.SolutionExplorer .

Если команда имеет сочетание клавиш, оно отображается в списке Сочетание клавиш для выбранной команды. If the command has a keyboard shortcut, it appears in the Shortcut(s) for selected command list.

Настройка сочетания клавиш Customize a keyboard shortcut

В строке меню выберите Сервис > Параметры. On the menu bar, choose Tools > Options.

Разверните пункт Среда и выберите элемент Клавиатура. Expand Environment, and then choose Keyboard.

Необязательно. Отфильтруйте список команд, введя полное имя команды без пробелов или его часть в поле Показать команды, содержащие. Optional: Filter the list of commands by entering all or part of the name of the command, without spaces, in the Show commands containing box.

Выберите из списка команду, которой нужно назначить сочетание клавиш. In the list, choose the command to which you want to assign a keyboard shortcut.

В списке Область действия выберите функциональную область, в которой будет использоваться данное сочетание клавиш. In the Use new shortcut in list, choose the feature area in which you want to use the shortcut.

Чтобы использовать сочетание в любом контексте, выберите Глобальная. For example, you can choose Global if you want the shortcut to work in all contexts. Вы можете выбрать любое сочетание клавиш, которое не используется в другом редакторе (например, как глобальное). You can use any shortcut that isn’t mapped (as Global) in another editor. В противном случае будет использование сочетание клавиш редактора. Otherwise, the editor overrides the shortcut.

В глобальном контексте невозможно назначать сочетания клавиш, включающие следующие клавиши: You can’t assign the following keys as part of a keyboard shortcut in Global:

• ВВОД, табуляция, CAPS LOCK; Enter, Tab, Caps Lock
• Print Scrn/Sys Rq, Scroll Lock, Pause/Break; Print Scrn/Sys Rq, Scroll Lock, Pause/Break
• Insert, Home, End, Page Up, Page Down; Insert, Home, End, Page Up, Page Down
• клавиша с логотипом Windows, клавиша приложения, любая из клавиш со стрелками; The Windows logo key, the Application key, any of the Arrow keys
• Num Lock, Delete или Clear на цифровой клавиатуре; Num Lock, Delete, or Clear on the numeric keypad
• сочетание клавиш Ctrl+Alt+Delete. The Ctrl+Alt+Delete key combination

В поле Введите сочетание клавиш введите требуемое сочетание клавиш. In the Press shortcut key(s) box, enter the shortcut that you want to use.

Вы можете создать сочетание клавиш, состоящее из буквы и клавиши ALT, CTRL или из обеих этих клавиш. You can create a shortcut that combines a letter with the Alt key, the Ctrl key, or both. Кроме того, можно создать сочетание клавиш, состоящее из клавиши SHIFT и буквы с клавишей ALT, CTRL или обеими этими клавишами. You can also create a shortcut that combines the Shift key and a letter with the Alt key, the Ctrl key, or both.

Если сочетание клавиш уже назначено другой команде, оно отображается в поле Сочетание клавиш в настоящий момент используется для. If a shortcut is already assigned to another command, it appears in the Shortcut currently used by box. В этом случае нажмите клавишу BACKSPACE, чтобы удалить сочетание клавиш, прежде чем пробовать другое сочетание. In that case, choose the Backspace key to delete that shortcut before you try a different one.

Нажмите кнопку Назначить. Choose the Assign button.

Если вы задали для команды другое сочетание клавиш, нажали Назначить, а затем кнопку Отмена, диалоговое окно закрывается, но изменение не отменяется. If you specify a different shortcut for a command, click Assign, and then click Cancel to close the dialog box, the shortcut you assigned is not reverted.

Совместное использование пользовательских сочетаний клавиш Share custom keyboard shortcuts

Вы можете поделиться своими сочетаниями клавиш, экспортировав их в файл, а затем передав этот файл другим пользователям, чтобы они импортировали данные из него. You can share your custom keyboard shortcuts by exporting them to a file and then giving the file to others so that they can import the data.

Экспорт сочетаний клавиш To export only keyboard shortcuts

В строке меню выберите Сервис > Импорт и экспорт параметров. On the menu bar, choose Tools > Import and Export Settings.

Выберите команду Экспортировать выбранные параметры среды и щелкните Далее. Choose Export selected environment settings, and then choose Next.

В области Выберите параметры для экспорта снимите флажок Все параметры, разверните узел Параметры, а затем узел Среда. Under What settings do you want to export?, clear the All Settings check box, expand Options, and then expand Environment.

Установите флажок Клавиатура и щелкните Далее. Select the Keyboard check box, and then choose Next.

В полях Выберите имя для файла параметров и Сохранить файл параметров в этом каталоге сохраните значения по умолчанию или укажите другие значения, а затем щелкните Готово. In the What do you want to name your settings file and Store my settings file in this directory boxes, either leave the default values or specify different values, and then choose Finish.

По умолчанию сочетания клавиш сохраняются в файле в папке %USERPROFILE%\Documents\Visual Studio 2017\Settings. By default, your shortcuts are saved in a file in the %USERPROFILE%\Documents\Visual Studio 2017\Settings folder. Имя файла содержит дату экспорта параметров и имеет расширение VSSETTINGS. The name of the file reflects the date when you exported the settings, and the extension is .vssettings.

По умолчанию сочетания клавиш сохраняются в файле в папке %USERPROFILE%\Documents\Visual Studio 2019\Settings. By default, your shortcuts are saved in a file in the %USERPROFILE%\Documents\Visual Studio 2019\Settings folder. Имя файла содержит дату экспорта параметров и имеет расширение VSSETTINGS. The name of the file reflects the date when you exported the settings, and the extension is .vssettings.

Импорт сочетаний клавиш To import only keyboard shortcuts

В строке меню выберите Сервис > Импорт и экспорт параметров. On the menu bar, choose Tools > Import and Export Settings.

Выберите вариант Импортировать выбранные параметры среды и щелкните Далее. Choose the Import selected environment settings option button, and then choose Next.

Выберите вариант Нет, импортировать новые значения, перезаписав мои текущие параметры, а затем щелкните Далее. Choose the No, just import new settings, overwriting my current settings option button, and then choose Next.

В окне Мои параметры выберите файл, содержащий нужные сочетания клавиш, или нажмите кнопку Обзор, чтобы найти нужный файл. Under My Settings, choose the file that contains the shortcuts that you want to import, or choose the Browse button to locate the correct file.

Нажмите кнопку Далее. Choose Next.

В области Выберите параметры для импорта снимите флажок Все параметры, разверните узел Параметры, а затем узел Среда. Under Which settings do you want to import?, clear the All Settings check box, expand Options, and then expand Environment.

Установите флажок Клавиатура и щелкните Готово. Select the Keyboard check box, and then choose Finish.