Метод IUIAutomation6::AddEventHandlerGroup (uiautomationclient.h)

Статья
03/03/2024

Регистрирует коллекцию методов обработчика событий, указанных в IUIAutomation6::CreateEventHandlerGroup.

Важно!

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

Синтаксис

HRESULT AddEventHandlerGroup(
  [in] IUIAutomationElement           *element,
       IUIAutomationEventHandlerGroup *handlerGroup
);

Параметры

[in] element

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

handlerGroup

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

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

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

Remarks

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

Событие может быть доставлено обработчику событий после отмены подписки на обработчик, если событие получено одновременно с запросом на отмену подписки на событие. Рекомендуется следовать стандарту COM и избегать уничтожения объекта обработчика событий до тех пор, пока его число ссылок не достигнет нуля. Удаление обработчика событий сразу после отмены подписки на события может привести к нарушению доступа, если событие доставлено с опозданием.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10, версия 1809 [только классические приложения]
Минимальная версия сервера	Windows Server версии 1709 [только классические приложения]
Целевая платформа	Windows
Header	uiautomationclient.h (включая UIAutomation.h)

См. также раздел

IUIAutomation6::RemoveEventHandlerGroup, интерфейс IUIAutomation6

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