Método IVsObjectList.GetNavigationInfo (UInt32, VSOBNAVIGATIONINFO2 )

Artigo
04/23/2016

Preenche o VSOBNAVIGATIONINFO2 estrutura para o item de lista fornecida, permitindo que a lista navegar de volta a ele por meio de LocateNavigationInfo.

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

Sintaxe

int GetNavigationInfo(
    uint index,
    VSOBNAVIGATIONINFO2[] pobNav
)

int GetNavigationInfo(
    unsigned int index,
    array<VSOBNAVIGATIONINFO2>^ pobNav
)

abstract GetNavigationInfo : 
        index:uint32 *
        pobNav:VSOBNAVIGATIONINFO2[] -> int

Function GetNavigationInfo (
    index As UInteger,
    pobNav As VSOBNAVIGATIONINFO2()
) As Integer

Parâmetros

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

pobNav
[in, out] Especifica informações de navegação.Valores são colocados em um VSOBNAVIGATIONINFO2 estrutura.

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::GetNavigationInfo(
   [in] ULONG Index,
   [in, out] VSOBNAVIGATIONINFO2 *pobNav
);

Quando um objeto tiver sido selecionado na Pesquisador de objetos ou Class Viewe o ambiente deve redesenhar o modo de exibição como resultado de uma classificação ou expansão, um caminho de volta para o item selecionado deve ser mantido.Entrará em contato com o ambiente GetNavigationInfo para o objeto selecionado e cada um dos seus pais, crescente a árvore até que o nó raiz seja alcançado.O ambiente pode então descender de árvore, com planos de LocateNavigationInfo para localizar o objeto originalmente selecionado.O ambiente cria o pobNav estruturar e passá-lo para você.Você pode preencher pobNav com valores apropriados para o index nó e a estrutura do retorno para o ambiente.A estrutura é mostrada abaixo para referência.

typedef struct _VSOBNAVIGATIONINFO2

{

GUID* pguididLib;

WCHAR* pszLibName;

VSOBNAVNAMEINFONODE* pName;

DWORD dwCustom;

}

Coloque o GUID da sua biblioteca em pguididLib e o nome da biblioteca pszLibName.Esses dois parâmetros geralmente não alterar toda a série de GetNavigationInfo chamadas.Você pode armazenar qualquer informação personalizada em dwCustom.VSOBNAVNAMEINFONODEé uma estrutura de lista vinculada que mantém o nome e tipo de cada nó na árvore de navegação.Definir esses valores apropriadamente para cada GetNavigationInfo de chamada.O ambiente lida com o endereçamento de lista vinculada.

Para obter mais detalhes sobre essas estruturas, consulte VSOBNAVIGATIONINFO2 e VSOBNAVNAMEINFONODE.

Consulte também

Interface IVsObjectList
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Partilhar via