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

Статья
08/08/2024

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

Важные клиентам службы автоматизации пользовательского интерфейса Майкрософт следует использовать методы группы обработчиков для регистрации прослушивателей событий вместо отдельных методов регистрации событий, определенных в различных пространствах имен IUIAutomation.

Синтаксис

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

Параметры

[in] scope

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

[in] changeTypes

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

[in] changesCount

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

[in] cacheRequest

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

[in] handler

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

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

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

Замечания

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

Требования

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

См. также

IUIAutomationEventHandlerGroup

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