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

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

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

 

Синтаксис

HRESULT AddPropertyChangedEventHandler(
  [in] TreeScope                                scope,
  [in] IUIAutomationCacheRequest                *cacheRequest,
  [in] IUIAutomationPropertyChangedEventHandler *handler,
  [in] PROPERTYID                               *propertyArray,
       int                                      propertyCount
);

Параметры

[in] scope

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

[in] cacheRequest

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

[in] handler

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

[in] propertyArray

Указатель на интересующие свойства автоматизации пользовательского интерфейса. Список идентификаторов свойств см. в разделе Идентификаторы свойств.

propertyCount

Количество отслеживаемых свойств.

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

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

Замечания

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

Требования

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

См. также

IUIAutomationEventHandlerGroup