Command.Bindings (Propiedad)
Establece u obtiene la lista de pulsaciones de tecla usadas para invocar al comando.
Espacio de nombres: EnvDTE
Ensamblado: EnvDTE (en EnvDTE.dll)
Sintaxis
'Declaración
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 propiedad
Tipo: 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+”, que se deben especificar en inglés. 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
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
Seguridad de .NET Framework
- 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.