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

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

Синтаксис

HRESULT UiaFind(
  [in]  HUIANODE        hnode,
  [in]  UiaFindParams   *pParams,
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] SAFEARRAY       **ppOffsets,
  [out] SAFEARRAY       **ppTreeStructures
);

Параметры

[in] hnode

Тип: HUIANODE

Узел, используемый в качестве начальной точки поиска.

[in] pParams

Тип: UiaFindParams*

Адрес структуры UiaFindParams , содержащей параметры поиска.

[in] pRequest

Тип: UiaCacheRequest*

Адрес структуры UiaCacheRequest , которая указывает, какие сведения следует кэшировать.

[out] ppRequestedData

Тип: SAFEARRAY**

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

[out] ppOffsets

Тип: SAFEARRAY**

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

[out] ppTreeStructures

Тип: SAFEARRAY**

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

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

Тип: 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