Propriedade Command.Bindings

Artigo
05/17/2015

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: Object
SafeArray de objetos.

Comentários

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

A sintaxe de cada cadeia de caracteres é qualquer um destes (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 espaço após qualquer separador de vírgula em uma sequê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 sequê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 Ferramentas Opções . Se você tentar definir essa propriedade para um comando, retornos de um erro.

Dica

Você não pode programaticamente alterar 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 Opções .Você pode então modificar as configurações no esquema de mapeamento.

Exemplos

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ável.