Método IVsObjectList.GetList (UInt32, UInt32, UInt32, VSOBSEARCHCRITERIA , IVsObjectList)

Artigo
04/23/2016

Retorna um filho IVsObjectList para a categoria especificada.

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

Sintaxe

int GetList(
    uint index,
    uint ListType,
    uint flags,
    VSOBSEARCHCRITERIA[] pobSrch,
    out IVsObjectList pplist
)

int GetList(
    unsigned int index,
    unsigned int ListType,
    unsigned int flags,
    array<VSOBSEARCHCRITERIA>^ pobSrch,
    [OutAttribute] IVsObjectList^% pplist
)

abstract GetList : 
        index:uint32 *
        ListType:uint32 *
        flags:uint32 *
        pobSrch:VSOBSEARCHCRITERIA[] *
        pplist:IVsObjectList byref -> int

Function GetList (
    index As UInteger,
    ListType As UInteger,
    flags As UInteger,
    pobSrch As VSOBSEARCHCRITERIA(),
    <OutAttribute> ByRef pplist As IVsObjectList
) 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.

pplist
[out] Ponteiro para o IVsObjectList 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 vsshell.idl:

HRESULT IVsObjectList::GetList(
   [in] ULONG Index,
   [in] LIB_LISTTYPE ListType,
   [in] LIB_LISTFLAGS Flags,
   [in] VSOBSEARCHCRITERIA *pobSrch,
   [out] IVsObjectList **ppList
);

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 GetCategoryField (index, LC_LISTTYPE).Em seguida, ele chama IVsObjectList.GetList com cada um dos tipos de lista retornados como suportados.

Em um LLT_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 GetList é chamado, sua biblioteca deve criar (ou reutilize o existente) um IVsObjectList 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 IVsObjectList
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Partilhar via