Функция UiaNavigate (uiautomationcoreapi.h)

Примечание Эта функция является нерекомендуемой. Вместо этого клиентские приложения должны использовать интерфейсы Com (Microsoft модель автоматизации пользовательского интерфейса).

 

Выполняет навигацию по дереву модель автоматизации пользовательского интерфейса, при необходимости извлекая кэшированные сведения.

Синтаксис

HRESULT UiaNavigate(
  [in]  HUIANODE          hnode,
  [in]  NavigateDirection direction,
  [in]  UiaCondition      *pCondition,
  [in]  UiaCacheRequest   *pRequest,
  [out] SAFEARRAY         **ppRequestedData,
  [out] BSTR              *ppTreeStructure
);

Параметры

[in] hnode

Тип: HUIANODE

Элемент, с которого начинается навигация.

[in] direction

Тип: NavigateDirection

Значение из перечисленного типа NavigateDirection , указывающее направление перехода с hnode.

[in] pCondition

Тип: UiaCondition*

Адрес структуры UiaCondition , указывающий условие, которому должен соответствовать перемещаемый элемент. Используйте этот параметр, чтобы пропустить элементы, которые не представляют интереса.

[in] pRequest

Тип: UiaCacheRequest*

Адрес структуры UiaCacheRequest , содержащей описание кэшируемых сведений.

[out] ppRequestedData

Тип: SAFEARRAY**

Адрес переменной, получающей указатель на SAFEARRAY , содержащий запрошенные данные. Этот параметр передается неинициализированным. См. заметки.

[out] ppTreeStructure

Тип: BSTR*

Адрес переменной, получающей описание древовидной структуры. Этот параметр передается неинициализированным. См. заметки.

Возвращаемое значение

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения или значение ошибки в противном случае.

Комментарии

Древовидная структура описывается строкой, где каждый символ имеет значение "p" или ""). Первый символ в строке всегда представляет корневой узел. Строка имеет значение NULL , если функция не возвращает никаких элементов.

"p" представляет узел (модель автоматизации пользовательского интерфейса элемент). Если одно "p" следует непосредственно за другим, второй узел является дочерним по отношению к первому. "") представляет собой шаг резервного копирования дерева. Например, "pp)p" представляет узел, за которым следуют два дочерних узла, которые являются общими элементами друг друга. В "pp))p" последний узел является одноуровневый узел первого узла.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	uiautomationcoreapi.h
Библиотека	Uiautomationcore.lib
DLL	Uiautomationcore.dll