Freigeben über


Command.Bindings-Eigenschaft

Aktualisiert: November 2007

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

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)

Eigenschaftenwert

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 "STRG+", "ALT+" und "UMSCHALT+". 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

Berechtigungen

Siehe auch

Referenz

Command-Schnittstelle

Command-Member

EnvDTE-Namespace

Weitere Ressourcen

Zuordnen von Add-In-Befehlen zu Tasten