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

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

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

 

Синтаксис

HRESULT AddStructureChangedEventHandler(
  [in] TreeScope                                 scope,
  [in] IUIAutomationCacheRequest                 *cacheRequest,
  [in] IUIAutomationStructureChangedEventHandler *handler
);

Параметры

[in] scope

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

[in] cacheRequest

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

[in] handler

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

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

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

Замечания

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

Требования

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

См. также

IUIAutomationEventHandlerGroup