IVsObjectList.LocateNavigationInfo(VSOBNAVIGATIONINFO2[], VSOBNAVNAMEINFONODE[], Int32, Int32, UInt32[]) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает индекс элемента списка, соответствующий структуре VSOBNAVIGATIONINFO2.
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
Параметры
- pobNav
- VSOBNAVIGATIONINFO2[]
[in] Указывает сведения о навигации. Значения находятся в структуре VSOBNAVIGATIONINFO2.
- pobName
- VSOBNAVNAMEINFONODE[]
[in] Указывает имя соответствующего узла. Значения находятся в структуре VSOBNAVNAMEINFONODE.
- fDontUpdate
- Int32
[in] Флаг, обозначающий отказ от обновлений.
- pfMatchedName
- Int32
[out] Указатель на флаг, указывающий, что найдено соответствие имени.
- pIndex
- UInt32[]
[out] Указатель на индекс расположенного элемента.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Подпись COM
Из всшелл. IDL:
HRESULT IVsObjectList::LocateNavigationInfo(
[in] VSOBNAVIGATIONINFO2 *pobNav,
[in] VSOBNAVNAMEINFONODE *pobName,
[in] BOOL fDontUpdate,
[out] BOOL *pfMatchedName,
[out] ULONG *pIndex
);
Если объект выбран в обозревателе объектов или представление классов и среда должна перерисовывать представление в результате сортировки или расширения, необходимо сохранить путь к выбранному элементу. Среда будет вызывать GetNavigationInfo выбранный объект и все его родительские элементы по возрастанию дерева до тех пор, пока не будет достигнут корневой узел. Затем среда может быть в нисходящем дереве с вызовами для LocateNavigationInfo перехода по узлам древовидного списка. VSOBNAVIGATIONINFO2Структура содержит идентификатор GUID и имя библиотеки. pobNameПараметр является указателем на структуру, VSOBNAVNAMEINFONODE содержащую имя и тип интересующего элемента. Когда вы найдете запрошенное имя, задайте pIndex для него соответствующее значение и установите для параметра pfMatchedName значение true . Если fDontUpdate задано значение, а запрошенный элемент не найден, возвращается E_FAIL . Если параметр fDontUpdate не установлен и вы не можете определить требуемый элемент, вернитесь в pIndex качестве null , и среда выполнит повторное создание списка объектов.