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