Método Windows2.Item (Object)

Artigo
10/26/2012

Retorna um membro indexado de um Windows coleção.

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

Sintaxe

'Declaração
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

Parâmetros

index
Tipo: System.Object
Obrigatório.O índice do item para retornar.

Valor de retorno

Tipo: EnvDTE.Window
A Window object.

Comentários

O valor passado para Index é um número inteiro que é um índice para um objeto em sua coleção.Para muitos objetos, no entanto, o valor de Index também pode ser um valor string que é igual a um objeto da coleção.O valor exato que é aceita pelo Item, porém, depende da coleção e sua implementação.

O Item método lança um ArgumentException exceção se a coleção não é possível localizar o objeto que corresponde ao valor de índice.

Exemplos

Este exemplo exibe a legenda de todos os itens do Windows2 coleção.

Para obter mais informações sobre como executar este exemplo como um add-in, consulte Como: compilar e executar os exemplos de código de modelo de objeto de automação.

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);
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.