Método IVsObjectList2.GetList2 (UInt32, UInt32, UInt32, VSOBSEARCHCRITERIA2 , IVsObjectList2)

Artigo
08/03/2016

Publicado: abril de 2016

Retorna um filho IVsObjectList2 para a categoria especificada.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop.8.0 (em Microsoft.VisualStudio.Shell.Interop.8.0.dll)

Sintaxe

int GetList2(
    uint index,
    uint ListType,
    uint flags,
    VSOBSEARCHCRITERIA2[] pobSrch,
    out IVsObjectList2 ppIVsObjectList2
)

int GetList2(
    unsigned int index,
    unsigned int ListType,
    unsigned int flags,
    array<VSOBSEARCHCRITERIA2>^ pobSrch,
    [OutAttribute] IVsObjectList2^% ppIVsObjectList2
)

abstract GetList2 : 
        index:uint32 *
        ListType:uint32 *
        flags:uint32 *
        pobSrch:VSOBSEARCHCRITERIA2[] *
        ppIVsObjectList2:IVsObjectList2 byref -> int

Function GetList2 (
    index As UInteger,
    ListType As UInteger,
    flags As UInteger,
    pobSrch As VSOBSEARCHCRITERIA2(),
    <OutAttribute> ByRef ppIVsObjectList2 As IVsObjectList2
) As Integer

Parâmetros

index
[in] Especifica o índice do item da lista de interesse.

ListType
[in] Especifica o tipo de lista que está sendo solicitado.Valores são obtidas a partir do _LIB_LISTTYPE enumeração.

flags
[in] Especifica os sinalizadores que controlam a solicitação de informações da lista de objeto.Valores são obtidas a partir do _LIB_LISTFLAGS enumeração.

pobSrch
[in] Não utilizados.Deve ser ignorado.

ppIVsObjectList2
[out] Ponteiro para o IVsObjectList2 interface da lista filho retornado.

Valor de retorno

Type: System.Int32

Se o método for bem-sucedido, ele retorna S_OK.Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De vsshell80.idl:

[C++]

HRESULT IVsObjectList2::GetList2(
   [in] ULONG Index, 
   [in] LIB_LISTTYPE2 ListType, 
   [in] LIB_LISTFLAGS Flags, 
   [in] VSOBSEARCHCRITERIA2 *pobSrch, 
   [out, retval] IVsObjectList2 **ppIVsObjectList2
);

Quando o usuário expande um nó da lista, o Gerenciador de objetos solicita a lista que filho listará suporta abaixo desse item de lista chamando GetCategoryField2 (index, LC_LISTTYPE).Em seguida, ele chama IVsObjectList2::GetList com cada um dos tipos de lista retornados como suportados.

Em um LC_PHYSICALCONTAINERS lista normalmente seria oferecem suporte a uma biblioteca de LLT_NAMESPACES, LLT_CLASSES, e LLT_MEMBERS lista.Em LLT_NAMESPACES lista, suporte a LLT_NAMESPACES (para namespaces aninhados), e LLT_MEMBERS.Em LLT_CLASSES lista, suporte a LLT_CLASSES (para classes aninhadas), e LLT_MEMBERS lista.LLT_HIERARCHYlistas podem aparecer em qualquer lugar para fornecer nós de informações auxiliares como, por exemplo, nós Bases e Interfaces, um nó de Classes derivadas e assim por diante.

Quando GetList2 é chamado, sua biblioteca deve criar (ou reutilize o existente) um IVsObjectList2 com base na categoria especificada para a ferramenta especificada (de acordo com os sinalizadores).Qualquer TTO_SORTTEXT cadeias de caracteres alocadas para os itens que são obtidos pelo Gerenciador de objeto por meio de chamadas subseqüentes para GetText deve ser mantido válido até a versão final da lista.

Consulte também

Interface IVsObjectList2
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Compartilhar via