Proprietà Command.Bindings

Articolo
08/11/2011

Ottiene o imposta l'elenco di sequenze di tasti utilizzate per richiamare il comando.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

'Dichiarazione
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)

Valore proprietà

Tipo: System.Object
SafeArray di oggetti.

Note

La proprietà Bindings imposta o restituisce un SafeArray di oggetti contenenti stringhe che descrivono tutte le combinazioni di tasti per il comando specificato. Le combinazioni vengono associate al comando quando vengono aggiunte a SafeArray, di cui viene eseguita successivamente la reimpostazione. Le combinazioni vengono eliminate dal comando quando vengono rimosse da SafeArray di cui viene eseguita successivamente la reimpostazione.

La sintassi di ogni stringa può essere una di quelle riportate di seguito (in cui "modificatori+" è facoltativo):

"nome ambito::modificatori+tasto"
"nome ambito::modificatori+tasto, modificatori+tasto"

I modificatori sono "ctrl+", "alt+" e "shift+". e possono essere inseriti in qualsiasi ordine. Il primo modificatore o identificatore del tasto è preceduto da due punti doppi ("::"). Non sono presenti spazi dopo il separatore virgola in una sequenza di tasti.

Tutti gli elementi sono specificati utilizzando maiuscole e minuscole, ad esempio "Ctrl+Space", ma è possibile utilizzare qualsiasi combinazione di maiuscole e minuscole quando si aggiungono nuove combinazioni.

Gli spazi sono gestiti come valori effettivi nelle stringhe di combinazioni. Non esistono sequenze escape per gli spazi e i caratteri di tabulazione e così via. Di seguito sono riportati alcuni esempi di impostazioni di combinazioni:

"Editor di testo::ctrl+r, ctrl+r"
"Global::ctrl+o"
"Global::f2"

La proprietà Bindings restituisce Nothing per i comandi che non possono avere combinazioni, vale a dire quelli che non vengono visualizzati nella pagina delle proprietà delle combinazioni della tastiera nella finestra di dialogo Opzioni del menu Strumenti. Se si tenta di impostare questa proprietà per un tale comando, viene restituito un errore.

Nota

Non è possibile modificare a livello di codice queste impostazioni per lo schema di mappatura della tastiera predefinito. Per modificare queste impostazioni, salvare una copia dello schema di mappatura della tastiera predefinito nel nodo Tastiera nella finestra di dialogo Opzioni. È possibile quindi modificare queste impostazioni nello schema di mappatura.

Esempi

' 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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.