Поделиться через

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

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

Синтаксис

HRESULT UiaNodeFromPoint(
  [in]  double          x,
  [in]  double          y,
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

Параметры

[in] x

Тип: double

Горизонтальная координата точки.

[in] y

Тип: double

Вертикальная координата точки.

[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