Propriedade Command.Bindings

Artigo
10/26/2012

Define ou obtém a lista de teclas usados para invocar o comando.

Namespace: EnvDTE
Assembly: EnvDTE (em EnvDTE.dll)

Sintaxe

'Declaração
Property Bindings As Object

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)

Valor de propriedade

Tipo: System.Object
SafeArray de objetos.

Comentários

Bindings define ou retorna SafeArray de objetos que contêm cadeias de caracteres que descrevem as associações de chave especificado para o comando.Você adiciona associações ao comando adicionando-os à SafeArray e então definindo as suporta mais tarde.Você remove as associações de linha de comando removendo as de SafeArray e então definindo as suporta mais tarde.

A sintaxe de cada cadeia de caracteres é qualquer um dos seguintes (onde “modifiers+” é opcional):

“scopename::modifiers+key”
“scopename::modifiers+key, modifiers+key”

Os modificadores são “ctrl+”, “alt+”, “e” shift+, que devem ser especificados em inglês.Podem aparecer em qualquer ordem.O primeiro especificador de modificador ou maneira de chave imediatamente os dois-pontos :: duplas (“”).Há um todo o espaço após o separador de vírgula em uma seqüência principal.

Tudo é relatado usando maiúsculas e minúsculas, como “Ctrl+Space”, mas você pode usar qualquer combinação dos casos ao adicionar novas associações.

Espaços são tratados como literais na cadeia de caracteres de associação.não há nenhuma seqüência de escape para o espaço e caracteres de tabulação, e assim por diante.Alguns exemplos de associar as configurações são:

“Texto Editor::ctrl+r, ctrl+r”
“Global::ctrl+o”
“Global::f2”

retorna Nothing deBindings para os comandos que não podem ter associações, isto é, não aparecem na página de propriedades associações de teclado de Opções de ferramentas .Se você tentar definir essa propriedade para um comando, retornos de um erro.

Observação
Você não pode alterar programaticamente as configurações para o esquema padrão de mapeamento do teclado.Para alterar as configurações, salvar uma cópia do esquema padrão de mapeamento do teclado no nó de Teclado na caixa de diálogo de Opções .Você pode então modificar as configurações no esquema de mapeamento.

Exemplos

' 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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.