Commands.Item-Methode

Artikel
08/10/2011

Gibt das indizierte Command-Objekt zurück.

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

Syntax

'Declaration
Function Item ( _
    index As Object, _
    ID As Integer _
) As Command

Command Item(
    Object index,
    int ID
)

Command^ Item(
    [InAttribute] Object^ index, 
    [InAttribute] int ID
)

abstract Item : 
        index:Object * 
        ID:int -> Command

function Item(
    index : Object, 
    ID : int
) : Command

Parameter

index
Typ: System.Object
Erforderlich.Ein absoluter Index, eine GUID-Zeichenfolge oder der vollständige Name eines Befehls.

ID
Typ: System.Int32
Optional.Die ID des Befehls im angegebenen Befehlssatz.

Rückgabewert

Typ: EnvDTE.Command
Ein Command-Objekt.

Hinweise

Wenn index ein absoluter Index (ein Long) ist, ist es nur sinnvoll, die Befehle von 1 bis n zu durchlaufen. Sie können den absoluten Index eines Befehls nicht speichern und verwenden, um später auf den Befehl zuzugreifen.

Wenn es sich bei index um eine GUID-Zeichenfolge handelt, gibt diese einen Befehlssatz an, und Sie müssen das ID-Argument angeben, um den Befehl in dem Satz zu bezeichnen.

Wenn Sie das ID-Argument angeben und es sich bei dem ersten Argument um eine Zeichenfolge handelt, muss das index-Argument eine GUID-Zeichenfolge sein, die einen Befehlssatz bezeichnet. Wenn index eine Zeichenfolge ist und kein ID-Argument vorhanden ist, muss index dem vollständigen Namen eines Befehls entsprechen. Ist index vom Typ Long, wird ID ignoriert.

Beispiele

' Macro code.
Sub ItemExample()
   Dim cmds As Commands
   Dim cmd As Command

   ' Set references to the Commands collection and the File.NewFile 
   ' command.
   cmds = DTE.Commands
   cmd = cmds.Item("File.NewFile")

   ' Assign 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.
   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.

Siehe auch

Referenz

Commands Schnittstelle

EnvDTE-Namespace

Freigeben über