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) |