Command.Bindings (Propiedad)

Artículo
08/23/2008

Actualización: noviembre 2007

Establece u obtiene la lista de pulsaciones de tecla usadas para invocar al comando.

Espacio de nombres: EnvDTE
Ensamblado: EnvDTE (en EnvDTE.dll)

Sintaxis

Property Bindings As Object

Dim instance As Command
Dim value As Object

value = instance.Bindings

instance.Bindings = value

Object Bindings { get; set; }

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

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

Valor de propiedad

Tipo: System.Object

Matriz SafeArray de objetos.

Comentarios

Bindings establece o devuelve una matriz SafeArray de objetos que contiene cadenas que describen todas las asignaciones de teclado para el comando especificado. Se pueden agregar asignaciones al comando agregándolas a la matriz SafeArray y estableciendo su valor después. Para quitar asignaciones del comando, primero se quitarán de la matriz SafeArray y, a continuación, se establecerá su valor de nuevo.

La sintaxis de cada cadena es una de las siguientes (donde "modificadores+" es opcional):

"ámbito::modificadores+clave"
"ámbito::modificadores+clave, modificadores+clave"

Los modificadores son "ctrl+", "alt+" y "shift+". Pueden aparecer en cualquier orden. El primer modificador o especificador de tecla sigue inmediatamente después a los dos puntos ("::"). Debe haber un espacio después de cada separador de coma en cada secuencia de teclas.

Todo se notifica con la inicial en mayúsculas y el resto en minúsculas (por ejemplo, "Ctrl+Barra espaciadora"), si bien puede utilizarse cualquier combinación de mayúsculas y minúsculas para agregar nuevas asignaciones.

Los espacios se consideran como literales en la cadena de asignación. No existen secuencias de escape para los espacios, caracteres de tabulación, etc. Algunos ejemplos de asignaciones:

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

Bindings devuelve Nothing para aquellos comandos que no tienen asignaciones de teclado; es decir, no aparecen en la página de propiedades de asignaciones de teclado del cuadro de diálogo Herramientas - Opciones. Si se intenta establecer esta propiedad para un comando de ese tipo, se devuelve un error.

Nota:
No es posible cambiar mediante programación la configuración del esquema predeterminado de asignación de teclado. Para cambiar la configuración, guarde una copia del esquema predeterminado de asignación de teclado en el nodo Teclado del cuadro de diálogo Opciones. A continuación podrá cambiar la configuración de dicho esquema.

Ejemplos

' 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

Permisos

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.