IVsObjectList.LocateNavigationInfo(VSOBNAVIGATIONINFO2[], VSOBNAVNAMEINFONODE[], Int32, Int32, UInt32[]) Método

Definição

Retorna o índice do item de lista correspondente à VSOBNAVIGATIONINFO2 estrutura.

public:
 int LocateNavigationInfo(cli::array <Microsoft::VisualStudio::Shell::Interop::VSOBNAVIGATIONINFO2> ^ pobNav, cli::array <Microsoft::VisualStudio::Shell::Interop::VSOBNAVNAMEINFONODE> ^ pobName, int fDontUpdate, [Runtime::InteropServices::Out] int % pfMatchedName, cli::array <System::UInt32> ^ pIndex);
int LocateNavigationInfo(std::Array <Microsoft::VisualStudio::Shell::Interop::VSOBNAVIGATIONINFO2> const & pobNav, std::Array <Microsoft::VisualStudio::Shell::Interop::VSOBNAVNAMEINFONODE> const & pobName, int fDontUpdate, [Runtime::InteropServices::Out] int & pfMatchedName, std::Array <unsigned int> const & pIndex);
public int LocateNavigationInfo (Microsoft.VisualStudio.Shell.Interop.VSOBNAVIGATIONINFO2[] pobNav, Microsoft.VisualStudio.Shell.Interop.VSOBNAVNAMEINFONODE[] pobName, int fDontUpdate, out int pfMatchedName, uint[] pIndex);
abstract member LocateNavigationInfo : Microsoft.VisualStudio.Shell.Interop.VSOBNAVIGATIONINFO2[] * Microsoft.VisualStudio.Shell.Interop.VSOBNAVNAMEINFONODE[] * int * int * uint32[] -> int
Public Function LocateNavigationInfo (pobNav As VSOBNAVIGATIONINFO2(), pobName As VSOBNAVNAMEINFONODE(), fDontUpdate As Integer, ByRef pfMatchedName As Integer, pIndex As UInteger()) As Integer

Parâmetros

pobNav
VSOBNAVIGATIONINFO2[]

no Especifica informações de navegação. Os valores estão em uma VSOBNAVIGATIONINFO2 estrutura.

pobName
VSOBNAVNAMEINFONODE[]

no Especifica o nome do nó de interesse. Os valores estão em uma VSOBNAVNAMEINFONODE estrutura.

fDontUpdate
Int32

no Sinalizador indicando não atualizar.

pfMatchedName
Int32

fora Ponteiro para um sinalizador que indica que um nome correspondente foi encontrado.

pIndex
UInt32[]

fora Ponteiro para o índice do item localizado.

Retornos

Int32

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

Comentários

Assinatura COM

De VSShell. idl:

HRESULT IVsObjectList::LocateNavigationInfo(  
   [in] VSOBNAVIGATIONINFO2 *pobNav,  
   [in] VSOBNAVNAMEINFONODE *pobName,  
   [in] BOOL fDontUpdate,  
   [out] BOOL *pfMatchedName,  
   [out] ULONG *pIndex  
);  

Quando um objeto tiver sido selecionado no pesquisador de objetos ou modo de exibição de classe, e o ambiente precisar redesenhar a exibição como resultado de uma classificação ou expansão, um caminho de volta para o item selecionado deverá ser mantido. O ambiente chamará GetNavigationInfo o objeto selecionado e cada um de seus pais, ascendendo a árvore até que o nó raiz seja atingido. O ambiente pode então reduzir a árvore, com chamadas para LocateNavigationInfo para percorrer os nós da lista de árvore. A VSOBNAVIGATIONINFO2 estrutura contém o GUID e o nome da biblioteca. O pobName parâmetro é um ponteiro para uma VSOBNAVNAMEINFONODE estrutura que contém o nome e o tipo do item de interesse. Quando você encontrar o nome solicitado, defina pIndex como o valor apropriado para o item e defina pfMatchedName como true . Se fDontUpdate estiver definido, e você não puder localizar o item solicitado, retorne E_FAIL . Se fDontUpdate não estiver definido e você não puder localizar o item solicitado, retornar pIndex como null e o ambiente irá regenerar a lista de objetos.

Aplica-se a