Практическое руководство. Сохранение существующих привязок клавиш к командам
Обновлен: Ноябрь 2007
Обычно, существующие привязки клавиш при их изменении для команды не сохраняются. Однако следующий пример демонстрирует способ привязки двух новых сочетаний клавиш к команде и сохранения существующих.
Чтобы просмотреть текущий список команд, запустите пример ListKeyBindings, представленный в разделе Практическое руководство. Просмотр существующих привязок к клавишам.
.gif "Примечание") Примечание. |
|---|
Отображаемые диалоговые окна и команды меню могут отличаться от описанных в справке в зависимости от текущих параметров или выпуска. Эти процедуры были разработаны с обычными параметрами разработки. Чтобы изменить настройки, в меню Сервис выберите команду Импорт и экспортпараметров. Дополнительные сведения см. в разделе Параметры Visual Studio. |
Чтобы добавить новые сочетания клавиш и сохранить существующие привязки клавиш для команд
Используйте Мастер надстроек Visual Studio для создания новой надстройки. Назовите проект и нажмите ОК для запуска мастера.
Дополнительные сведения об использовании Мастера надстроек Visual Studio см. в разделе Практическое руководство. Создание надстройки.
На странице Выбрать язык программирования выберите Создать надстройку, используя Visual C# для запуска следующего примера Visual C# или Создать надстройку, используя Visual Basic для запуска примера Visual Basic.
Вставьте следующий пример функции в класс Connect кода, созданного Мастером надстроек Visual Studio.
Чтобы создать копию параметров клавиатуры по умолчанию, перейдите в каталог C:\Program Files\Microsoft Visual Studio 8\Common7\IDE.
Щелкните правой кнопкой на файлах VSK и в контекстном меню выберите пункт Копировать.
Вставьте копию в той же папке.
Копия будет иметь имя "Копия <имя VSK-файла>".
Переименуйте скопированный файл.
Чтобы удостовериться, что VSK-файл появился в списке привязок к клавиатуре, в Visual Studio в меню Сервис выберите Параметры.
В левой области диалогового окна Параметры разверните папку Среда и выберите Клавиатура.
Убедитесь, что имя VSK-файла, указанного на шаге 7, появилось в раскрывающемся меню Применить следующую дополнительную схему назначений клавиш.
Перед запуском примера надстройки убедитесь, что привязки к клавиатуре имеют значение(По умолчанию). Это можно сделать, щелкнув Сброс в панели Клавиатура в диалоговом окне Параметры.
Замените <Filename.vsk> новым именем схемы клавиатуры, указанным в шаге 7, в шаге prop.Value = "< Filename.vsk>" примера надстройки.
Вызовите функцию из метода OnConnection, как описано в разделе Практическое руководство. Компиляция и выполнение примеров кода модели объектов автоматизации.
Выполните построение надстройки.
Чтобы запустить надстройку, в меню Сервис щелкните Диспетчер надстроек, выберите созданную надстройку и нажмите ОК.
Команда File.NewFile привязывается к новым сочетаниям клавиш (CTRL+ALT+SHIFT+Y и CTRL+ALT+SHIFT+U), а также исходным сочетаниям.
Пример
Следующий пример надстройки демонстрирует способ привязки двух новых сочетаний клавиш к команде с сохранением существующих.
Sub PreserveBindings()
' Adds two new key bindings while preserving the existing ones.
Dim cmds As Commands
Dim cmd As Command
Dim props As EnvDTE.Properties = DTE.Properties("Environment", _
"Keyboard")
Dim prop As EnvDTE.Property
Dim bindings() As Object
Dim bindingNumber As Integer
' Set references to the Commands collection and the File.NewFile
' command.
cmds = DTE.Commands
cmd = cmds.Item("File.NewFile")
' Make a writeable copy of the default keymapping scheme.
prop = props.Item("SchemeName")
prop.Value = "<FileName.vsk>"
' Retrieve the current bindings for the command.
bindings = cmd.Bindings
' Get the number of bindings for the command.
bindingNumber = bindings.Length
' Add two more elements to the array to accomodate two
' new commands.
ReDim Preserve bindings(bindingNumber + 1)
' Add the new bindings to the existing ones in the array.
bindings(bindingNumber) = "Global::CTRL+ALT+SHIFT+Y"
bindings(bindingNumber + 1) = "Global::CTRL+ALT+SHIFT+U"
' Assign the contents of the bindings array to the Bindings
' property.
cmd.Bindings = bindings
End Sub
public void OnConnection(object application,
Extensibility.ext_ConnectMode connectMode, object addInInst, ref
System.Array custom)
{
_applicationObject = (DTE2)application;
_addInInstance = (AddIn)addInInst;
// Pass the applicationObject member variable to the code example.
PreserveBindings((_applicationObject);
}
// Add-in example for TextSelection.FindPattern.
// Also shows usage of these methods and properties:
// TextSelection.SelectLine
public void PreserveBindings( DTE dte )
{
// Adds two new key bindings while preserving the existing ones.
Commands cmds = null;
Command cmd = null;
EnvDTE.Properties props = dte.get_Properties( "Environment",
"Keyboard");
EnvDTE.Property prop = null;
Object[] bindings = null;
int bindingNumber = 0;
// Set references to the Commands collection and the File.NewFile
// command.
cmds = dte.Commands;
cmd = cmds.Item( "File.NewFile", -1 );
// Make a writeable copy of the default keymapping scheme.
prop = props.Item( "SchemeName" );
prop.Value = "<FileName.vsk>";
// Retrieve the current bindings for the command.
bindings = ( ( System.Object[] )( cmd.Bindings ) );
// Get the number of bindings for the command.
bindingNumber = bindings.Length;
// Add two more elements to the array to accomodate two
// new commands.
// Create temp variable for copying values.
// Arrays are zero-based in C#.
object[] temp = new object[ bindingNumber + 2 ];
System.Array.Copy( bindings, temp, Math.Min( bindings.Length,
temp.Length ) );
bindings = temp;
// Add the new bindings to the existing ones in the array.
bindings[ bindingNumber ] = "Global::CTRL+ALT+SHIFT+Y";
bindings[ bindingNumber+1 ] = "Global::CTRL+ALT+SHIFT+U";
// Assign the contents of the bindings array to the Bindings
// property.
cmd.Bindings = bindings;
}
См. также
Задачи
Практическое руководство. Привязка команды к одному сочетанию клавиш
Практическое руководство. Привязка команды к нескольким сочетаниям клавиш
Основные понятия
Формат параметров свойства привязки