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

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

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

Синтаксис

HRESULT UiaNodeFromFocus(
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

Параметры

[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