IUIAutomation6::AddEventHandlerGroup 方法 (uiautomationclient.h)
使用 IUIAutomation6::CreateEventHandlerGroup 註冊指定的事件處理程式方法集合。
重要
Microsoft 使用者介面自動化 客戶端應該使用處理程式群組方法來註冊事件接聽程式,而不是各種 IUIAutomation 介面命名空間中定義的個別事件註冊方法。
語法
HRESULT AddEventHandlerGroup(
[in] IUIAutomationElement *element,
IUIAutomationEventHandlerGroup *handlerGroup
);
參數
[in] element
與事件處理程式群組相關聯之 使用者介面自動化 專案的指標。
handlerGroup
使用者介面自動化 事件接聽程式的集合。
傳回值
如果此方法成功,則會傳回S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
實作事件處理程式之前,您應該先熟悉了解 線程問題中所述的線程問題。
如果事件與取消訂閱事件的要求同時收到,則事件可以在未訂閱處理程式之後傳遞至事件處理程式。 最佳做法是遵循元件物件模型 (COM) 標準,並避免終結事件處理程序物件,直到其參考計數達到零為止。 取消訂閱事件之後立即終結事件處理程式,可能會導致延遲傳遞事件時發生存取違規。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 版本 1809 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 版本 1709 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | uiautomationclient.h (包含 UIAutomation.h) |