Método IVsLiteTreeList.GetText (UInt32, VSTREETEXTOPTIONS, String)

Artigo
06/13/2016

Retorna um ponteiro para as representações de texto para o item de lista de árvore solicitada.

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

Sintaxe

int GetText(
    uint index,
    VSTREETEXTOPTIONS tto,
    out string ppszText
)

int GetText(
    unsigned int index,
    VSTREETEXTOPTIONS tto,
    [OutAttribute] String^% ppszText
)

abstract GetText : 
        index:uint32 *
        tto:VSTREETEXTOPTIONS *
        ppszText:string byref -> int

Function GetText (
    index As UInteger,
    tto As VSTREETEXTOPTIONS,
    <OutAttribute> ByRef ppszText As String
) As Integer

Parâmetros

index
[in] Especifica o zero com base no índice do item de interesse.

tto
[in] Especifica o tipo de texto que está sendo solicitado.Valores são obtidas a partir do VSTREETEXTOPTIONS enumeração.

ppszText
[out] Ponteiro para uma seqüência de texto do item da lista de árvore especificada.Os implementadores devem alocar essa seqüência de caracteres e manter o ponteiro válido de acordo com os comentários abaixo.

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 IVsLiteTreeList::GetText(
   [in] ULONG Index,
   [in] VSTREETEXTOPTIONS tto,
   [out] const WCHAR **ppszText
);

Esse método retorna um ponteiro para uma seqüência de caracteres que contém vários elementos de texto para o item de lista de árvore.String ponteiros retornados para TTO_SORTTEXT deve permanecer válido e inalterado por toda a vida da lista, como eles são usados para classificar e recorrer a lista continuamente.String ponteiros para outros VSTREETEXTOPTIONS valores de enumeração somente precisam permanecer intacta até o próximo GetText chamada, momento em que eles podem ser descartados ou reutilizados.

Observação
O buffer de texto é criado pelo IVsLiteTreeList objeto e o buffer devem persistir durante a vida da IVsLiteTreeList objeto. Se você estiver implementando essa interface em código gerenciado e você precisa ter a seqüência de caracteres alienado pelo chamador, implementar a IVsCoTaskMemFreeMyStrings interface na IVsLiteTreeList interface.

O buffer de texto é criado pelo IVsLiteTreeList objeto e o buffer devem persistir durante a vida da IVsLiteTreeList objeto.

Se você estiver implementando essa interface em código gerenciado e você precisa ter a seqüência de caracteres alienado pelo chamador, implementar a IVsCoTaskMemFreeMyStrings interface na IVsLiteTreeList interface.

Consulte também

Interface IVsLiteTreeList
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Compartilhar via