Command.Bindings - свойство

Статья
08/11/2011

Задает или получает список нажатых для вызова команды клавиш.

Пространство имен: EnvDTE
Сборка: EnvDTE (в EnvDTE.dll)

Синтаксис

'Декларация
Property Bindings As Object
    Get
    Set

Object Bindings { get; set; }

property Object^ Bindings {
    Object^ get ();
    void set (Object^ value);
}

abstract Bindings : Object with get, set

function get Bindings () : Object
function set Bindings (value : Object)

Значение свойства

Тип: System.Object
Массив SafeArray объектов.

Заметки

Bindings задает или возвращает массив объектов SafeArray, содержащий строки с описанием всех сочетаний клавиш для указанной команды. Сочетания для команды можно добавлять, добавляя их в массив SafeArray и затем настраивая их на команду. Удалять сочетания для команды можно, удаляя их из массива SafeArray и затем настраивая команду на работу без сочетания клавиш.

Есть два варианта синтаксиса строки (при этом элемент "модификаторы+" необязателен):

"scopename::модификаторы+клавиша"
"scopename::модификаторы+клавиша, модификаторы+клавиша"

Существуют модификаторы "ctrl+", "alt+", и "shift+". Они могут использоваться в любом порядке. Первый модификатор или спецификатор клавиши следует непосредственно за двойным двоеточием ("::"). После любой разделяющей запятой в последовательности клавиш должен идти один пробел.

Всегда сообщается смешанный регистр, например "Ctrl+Space", но при добавлении новых сочетаний можно использовать любое сочетание регистров.

В строке сочетания клавиш пробелы обрабатываются как литералы. Для таких знаков, как пробелы, знаки табуляции и так далее, не существует escape-последовательностей. Несколько примеров параметров сочетаний клавиш:

"Text Editor::ctrl+r, ctrl+r"
"Global::ctrl+o"
"Global::f2"

Bindings возвращает Nothing для команд, которые не могут иметь сочетания клавиш, то есть если их нет на странице свойств сочетаний клавиш Сервис Параметры. Попытка установить это свойство для таких команд вызовет ошибку.

Примечание

Программно изменять параметры сопоставления клавиш по умолчанию невозможно.Чтобы изменить эти параметры, сохраните копию схемы сопоставления клавиш по умолчанию в узле Клавиатура диалогового окна Параметры.После этого параметры схемы можно изменить.

Примеры

' Macro code.
Sub BindingsExample()
    Dim cmds As Commands
    Dim cmd As Command
    Dim props As EnvDTE.Properties = DTE.Properties("Environment", _
    "Keyboard")
    Dim prop As EnvDTE.Property

    ' Set references to the Commands collection and the File.NewFile 
    ' command.
    cmds = DTE.Commands
    cmd = cmds.Item("File.NewFile")

    ' Assigns the command (File.NewFile) globally to the F2 key.
    ' Because you cannot programmatically change the default keyboard 
    ' mapping scheme settings, you must first make a copy of the 
    ' Default Settings for the Keyboard Mapping Scheme.
    prop = props.Item("Scheme")
    ' Sets the Scheme property value to a new keyboard scheme.
    ' This saves the old keyboard mapping scheme and allows you 
    ' to add new key mappings.
    MsgBox("PROP NAME: " & prop.Name & "   VALUE: " & prop.Value)
    prop.Value = "C:\Documents and Settings\johndoe\Application _
    Data\Microsoft\VisualStudio\8.0\MyNewKbdScheme.vsk"
    MsgBox("PROP NAME: " & prop.Name & "   VALUE: " & prop.Value)
    cmd.Bindings = "Global::f2"
End Sub

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.