IVsObjectList.LocateNavigationInfo(VSOBNAVIGATIONINFO2[], VSOBNAVNAMEINFONODE[], Int32, Int32, UInt32[]) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.