共用方式為


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)

另請參閱

IUIAutomation6::RemoveEventHandlerGroupIUIAutomation6 介面