Метод IUIAutomation4::AddChangesEventHandler (uiautomationclient.h)

Статья
08/08/2024

Регистрирует метод, обрабатывающий события изменения.

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

Синтаксис

HRESULT AddChangesEventHandler(
  [in] IUIAutomationElement             *element,
  [in] TreeScope                        scope,
  [in] int                              *changeTypes,
  [in] int                              changesCount,
  [in] IUIAutomationCacheRequest        *pCacheRequest,
  [in] IUIAutomationChangesEventHandler *handler
);

Параметры

[in] element

Тип: IUIAutomationElement*

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

[in] scope

Тип: TreeScope

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

[in] changeTypes

Тип: int*

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

[in] changesCount

Тип: int

Количество изменений, произошедших в этом событии.

[in] pCacheRequest

Тип: IUIAutomationCacheRequest*

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

[in] handler

Тип: IUIAutomationChangesEventHandler*

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

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

Тип: HRESULT

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

Замечания

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1607 [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2016 [только классические приложения]
целевая платформа	Виндоус
заголовка	uiautomationclient.h (include UIAutomation.h)

См. также

IUIAutomation4

RemoveAllEventHandlers

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