IVsObjectList2.LocateNavigationInfo2(VSOBNAVIGATIONINFO3[], VSOBNAVNAMEINFONODE2[], Int32, Int32, UInt32) Método

Definição

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

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

Parâmetros

pobNav
VSOBNAVIGATIONINFO3[]

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

pobName
VSOBNAVNAMEINFONODE2[]

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

fDontUpdate
Int32

no Sinalizador que indica que nenhuma atualização deve ser feita.

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 vsshell80. idl:

[C++]

HRESULT IVsObjectList2::LocateNavigationInfo2(  
   [in] VSOBNAVIGATIONINFO3 *pobNav,   
   [in] VSOBNAVNAMEINFONODE2 *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 chama GetNavigationInfo2 o objeto selecionado e cada um de seus pais, ascendente na árvore até que o nó raiz seja atingido. O ambiente pode então reduzir a árvore, com chamadas para LocateNavigationInfo2 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 regenera a lista de objetos.

Aplica-se a