Windows2.Item-Methode (Object)

Artikel
08/10/2011

Gibt einen indizierten Member einer Windows-Auflistung zurück.

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

Syntax

'Declaration
Function Item ( _
    index As Object _
) As Window

Window Item(
    Object index
)

Window^ Item(
    [InAttribute] Object^ index
)

abstract Item : 
        index:Object -> Window

function Item(
    index : Object
) : Window

Parameter

index
Typ: System.Object
Erforderlich.Der Index des zurückzugebenden Elements.

Rückgabewert

Typ: EnvDTE.Window
Ein Window-Objekt.

Implementiert

Windows.Item(Object)

Hinweise

Der an Index übergebene Wert ist eine ganze Zahl, die ein Index für ein Objekt in dessen Auflistung ist. Bei vielen Objekten kann es sich bei dem Wert von Index aber auch um einen Zeichenfolgewert handeln, der einem Objekt in der Auflistung entspricht. Der genaue von Item akzeptierte Wert hängt jedoch von der Auflistung und deren Implementierung ab.

Die Item-Methode löst eine ArgumentException-Ausnahme aus, wenn die Auflistung das dem Indexwert entsprechende Objekt nicht finden kann.

Beispiele

In diesem Beispiel wird die Beschriftung aller Elemente in der Windows2-Auflistung angezeigt.

Weitere Informationen zum Ausführen dieses Beispiels als Add-In finden Sie unter Gewusst wie: Kompilieren und Ausführen der Codebeispiele für das Automatisierungsobjektmodell.

Imports EnvDTE
Imports EnvDTE80
Public Sub OnConnection(ByVal application As Object, _
 ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
 ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    _applicationObject = CType(application, DTE2)
    _addInInstance = CType(addInInst, AddIn)
    IterateItems(_applicationObject)
End Sub
Sub IterateItems(ByVal dte As DTE2)
    Dim win As Windows2
    win = CType(_applicationObject.Windows, EnvDTE80.Windows2)
    Dim aString As String
    aString = ""
    Dim count As Integer
    count = win.Count
    Dim i As Integer
    For i = 1 To count Step 1
        aString = aString & "The window number " & i & _
 " in the collection, has the caption: " & win.Item(i).Caption & vbCr
    Next
    MsgBox(aString)
End Sub

using EnvDTE;
using EnvDTE80;
using System.Windows.Forms;
public void OnConnection(object application, 
ext_ConnectMode connectMode, object addInInst, ref Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    IterateItems(_applicationObject);
}
public void IterateItems(DTE2 dte)
{
    Windows2 win;
    win = (EnvDTE80.Windows2)_applicationObject.Windows;
    int count = win.Count;
    String aString = null;
    for (int i = 1; i <= count; i++ )
    {
        aString = aString + ("The window number " + i + 
" in the collection, has the caption: " + win.Item(i).Caption + "\n");
    }
    MessageBox.Show(aString);
}

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