Command.Bindings-Eigenschaft

Artikel
10/24/2012

Legt die Liste der Tastatureingaben fest, die zum Aufrufen des Befehls verwendet werden, oder ruft sie ab.

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

Syntax

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

Eigenschaftswert

Typ: System.Object
Ein SafeArray von Objekten.

Hinweise

Bindings legt ein SafeArray von Objekten fest, die Zeichenfolgen zur Beschreibung aller Tastenzuordnungen für den jeweiligen Befehl enthalten, oder gibt es zurück.Sie fügen dem Befehl Zuordnungen hinzu, indem Sie sie in das SafeArray einfügen, woraufhin dieses zurückgesetzt werden muss.Sie entfernen Zuordnungen von dem Befehl, indem Sie sie aus dem SafeArray löschen, woraufhin dieses zurückgesetzt werden muss.

Die Syntax für jede Zeichenfolge ist aufgebaut wie eines der folgenden Beispiele (wobei "Modifizierer+" optional ist):

"Bereichname::Modifizierer+Taste"
"Bereichname::Modifizierer+Taste, Modifizierer+Taste"

Modifizierer sind "ctrl+", "alt+" und "shift+", die auf Englisch angegeben werden müssen.Sie können in beliebiger Reihenfolge vorkommen.Der erste Modifizierer oder Tastenbezeichner folgt unmittelbar auf den doppelten Doppelpunkt ("::").In einer Tastenfolge befindet sich nach jedem Kommatrennzeichen ein Leerzeichen.

Alle Tastatureingaben werden in gemischter Groß-/Kleinschreibung wiedergegeben, beispielsweise "Strg+Leertaste", Sie können jedoch eine beliebige Kombination aus Groß-/Kleinschreibung verwenden, um neue Zuordnungen hinzuzufügen.

Leerzeichen werden als Literalzeichen ("wörtlich") innerhalb der Bindungszeichenfolge behandelt.Es gibt keine Escapesequenzen für das Leerzeichen und den Tabulator usw.Im Folgenden einige Beispiele für Bindungsfestlegungen:

"Text-Editor::strg+r, strg +r"
"Global::strg+o"
"Global::f2"

Bindings gibt für Befehle, denen keine Zuordnungen zugewiesen werden können, Nothing zurück, was bedeutet, dass diese Befehle nicht auf der Eigenschaftenseite Tastatur (Menü Extras, Dialogfeld Optionen) angezeigt werden.Wenn Sie versuchen, diese Eigenschaft für einen derartigen Befehl festzulegen, wird ein Fehler zurückgegeben.

Hinweis
Sie können die Einstellungen für das Standardzuordnungsschema der Tastatur nicht programmgesteuert ändern.Um die Einstellungen zu ändern, speichern Sie eine Kopie des Standardzuordnungsschemas der Tastatur im Dialogfeld Optionen unter dem Knoten Tastatur.Dann können Sie die Einstellungen in diesem Zuordnungsschema ändern.

Beispiele

' 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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.