Windows2.Item - метод (Object)

Статья
08/11/2011

Возвращает индексированный элемент коллекции Windows.

Пространство имен: EnvDTE80
Сборка: EnvDTE80 (в EnvDTE80.dll)

Синтаксис

'Декларация
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

Параметры

index
Тип: System.Object
Обязательный.Индекс элемента, который должен быть возвращен.

Возвращаемое значение

Тип: EnvDTE.Window
Объект Window.

Реализации

Windows.Item(Object)

Заметки

Значение, переданное в Index, представляет собой целое число, которое является индексом объекта в его коллекции. Для многих объектов значение Index также может быть строкой, которая указывает на объект в коллекции. Точное значение, которое допустимо для Item, зависит от коллекции и ее реализации.

Если коллекция не может найти объект, который соответствует значению индекса, метод Item вызывает исключение ArgumentException.

Примеры

В следующем примере выводятся заголовки всех элементов коллекции Windows2.

Дополнительные сведения о запуске этого примера в виде надстройки см. в разделе Практическое руководство. Компиляция и выполнение примеров кода модели объектов автоматизации.

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

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.