IUIAutomation6::AddEventHandlerGroup 方法 (uiautomationclient.h)

注册使用 IUIAutomation6::CreateEventHandlerGroup 指定的事件处理程序方法的集合。

重要

Microsoft UI 自动化客户端应使用处理程序组方法来注册事件侦听器,而不是各种 IUIAutomation 接口命名空间中定义的单个事件注册方法。

语法

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

参数

[in] element

指向与事件处理程序组关联的 UI 自动化 元素的指针。

handlerGroup

UI 自动化事件侦听器的集合。

返回值

如果该方法成功,则返回 S_OK。 否则,它将返回 HRESULT 错误代码。

备注

在实现事件处理程序之前,应熟悉了解线程处理问题中所述 的线程问题

如果事件与取消订阅事件的请求同时收到,则事件可以在取消订阅处理程序后传递到事件处理程序。 最佳做法是遵循组件对象模型 (COM) 标准,并避免销毁事件处理程序对象,直到其引用计数达到零。 如果事件延迟传递,则取消订阅事件后立即销毁事件处理程序可能会导致访问冲突。

要求

要求
最低受支持的客户端 Windows 10 版本 1809 [仅限桌面应用]
最低受支持的服务器 Windows Server 版本 1709 [仅限桌面应用]
目标平台 Windows
标头 uiautomationclient.h (包括 UIAutomation.h)

另请参阅

IUIAutomation6::RemoveEventHandlerGroupIUIAutomation6 接口