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

Статья
08/26/2023

Примечание Эта функция является нерекомендуемой. Клиентские приложения должны использовать вместо этого интерфейсы COM модели компонентов автоматизации пользовательского интерфейса Майкрософт.

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

Синтаксис

HRESULT UiaAddEvent(
  [in]  HUIANODE         hnode,
  [in]  EVENTID          eventId,
  [in]  UiaEventCallback *pCallback,
  [in]  TreeScope        scope,
  [in]  PROPERTYID       *pProperties,
  [in]  int              cProperties,
  [in]  UiaCacheRequest  *pRequest,
  [out] HUIAEVENT        *phEvent
);

Параметры

[in] hnode

Тип: HUIANODE

Узел, в который добавляется прослушиватель событий.

[in] eventId

Тип: EVENTID

Идентификатор события для прослушивания. Список идентификаторов событий см. в разделе Идентификаторы событий.

[in] pCallback

Тип: UiaEventCallback*

Адрес определяемой приложением функции обратного вызова UiaEventCallback , которая вызывается при возникновении события.

[in] scope

Тип: TreeScope*

Значение из перечисленного типа TreeScope, указывающее область событий, которые необходимо обрабатывать, т. е. относятся ли они к самому элементу или к его предкам и дочерним элементам.

[in] pProperties

Тип: PROPERTYID*

Адрес массива, содержащего идентификаторы свойств для отслеживания событий изменений, если eventId является идентификатором EVENTID, производным от AutomationPropertyChanged_Event_GUID; В противном случае этот параметр имеет значение NULL. Список идентификаторов свойств см. в разделе Идентификаторы свойств.

[in] cProperties

Тип: int

Количество элементов в массиве pProperties .

[in] pRequest

Тип: UiaCacheRequest*

Адрес структуры UiaCacheRequest , которая определяет запрос кэша, который действует для узлов, возвращаемых с событиями.

[out] phEvent

Тип: HUIEVENT*

При возврате этой функции содержит указатель на добавляемое событие. Этот параметр передается неинициализированным.

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

Тип: HRESULT

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

Требования


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

См. также раздел

UiaLookupId

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