Метод IUIAutomation::AddAutomationEventHandler (uiautomationclient.h)

Статья
08/08/2024

Регистрирует метод, обрабатывающий события автоматизации пользовательского интерфейса Майкрософт.

Примечание Перед реализацией обработчика событий необходимо ознакомиться с проблемами потоков, описанными в статье Основные сведения о проблемах потоков.

Синтаксис

HRESULT AddAutomationEventHandler(
  [in] EVENTID                   eventId,
  [in] IUIAutomationElement      *element,
  [in] TreeScope                 scope,
  [in] IUIAutomationCacheRequest *cacheRequest,
  [in] IUIAutomationEventHandler *handler
);

Параметры

[in] eventId

Тип: EVENTID

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

[in] element

Тип: IUIAutomationElement*

Указатель на элемент автоматизации пользовательского интерфейса, связанный с обработчиком событий.

[in] scope

Тип: TreeScope

Область обработки событий; то есть, находятся ли они на самом элементе, или на его предках и потомках.

[in] cacheRequest

Тип: IUIAutomationCacheRequest*

Указатель на запрос кэша или NULL, если кэширование не требуется.

[in] handler

Тип: IUIAutomationEventHandler*

Указатель на объект, обрабатывающий событие.

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

Тип: HRESULT

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

Замечания

Клиент службы автоматизации пользовательского интерфейса не должен использовать несколько потоков для добавления или удаления обработчиков событий. Непредвиденное поведение может привести к добавлению или удалению одного обработчика событий при добавлении или удалении другого в одном процессе клиента.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista, Windows XP с пакетом обновления 3 (SP3) и обновление платформы для Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и обновлением платформы для Windows Server 2008, Windows Server 2003 с пакетом обновления 2 (SP2) и обновлением платформы для Windows Server 2008 [классические приложения только]
целевая платформа	Виндоус
заголовка	uiautomationclient.h (include UIAutomation.h)