Propriedade Command.Bindings

Artigo
08/01/2011

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

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

Sintaxe

'Declaração
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)

Valor de propriedade

Tipo: System.Object
A SafeArray de objetos.

Comentários

BindingsDefine ou retorna um SafeArray de objetos que contêm seqüências de caracteres que descrevem todas as vinculações de chaves para o comando especificado. Adicionar ligações ao comando, adicionando-os para o SafeArray e, em seguida, defini-la de volta posteriormente. Remova as ligações do comando, removê-los a partir de SafeArray e, em seguida, defini-la de volta posteriormente.

A sintaxe de cada seqüência de caracteres é uma das seguintes (onde "modificadores +" é opcional):

"scopename::modifiers + tecla"
"scopename::modifiers + tecla, modificadores +"

Modificadores são "ctrl +", "alt +" e "shift +". Eles podem aparecer em qualquer ordem. O modificador primeiro ou o especificador de chave segue imediatamente os dois-pontos duplo (":"). Há um espaço após qualquer virgula uma seqüência de teclas.

Tudo o que está sendo informado pelo uso de maiúsculas e minúsculas, como, por exemplo, "Ctrl + espaço", mas você pode usar qualquer combinação de maiúsculas, ao adicionar novas ligações.

Espaços são tratados como literais de seqüência de vinculação. Não há nenhum seqüências de escape para o espaço e caracteres de tabulação e assim por diante. Estes são alguns exemplos de configurações de ligação:

"Editor de texto:: ctrl + r, ctrl + r."
"Global:: ctrl + o"
"Global::f2"

BindingsRetorna Nothing para os comandos que não podem ter ligações, ou seja, eles não aparecerão na Opções de ferramentas página de propriedades de ligações de teclado. Se você tentar definir essa propriedade para esse comando, retorna um erro.

Observação
Programaticamente, você não pode alterar as configurações para o esquema de mapeamento de teclado padrão. Para alterar as configurações, salve uma cópia do esquema de mapeamento de teclado padrão no teclado nó a Opções caixa de diálogo. Em seguida, você pode alterar as configurações desse 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.