共用方式為

IUIAutomation4：：AddChangesEventHandler 方法 （uiautomationclient.h）

  • 發行項

註冊處理變更事件的方法。

注意 實作事件處理程式之前，您應該熟悉 瞭解線程問題中所述的線程問題。
 

語法

HRESULT AddChangesEventHandler(
  [in] IUIAutomationElement             *element,
  [in] TreeScope                        scope,
  [in] int                              *changeTypes,
  [in] int                              changesCount,
  [in] IUIAutomationCacheRequest        *pCacheRequest,
  [in] IUIAutomationChangesEventHandler *handler
);

參數

[in] element

類型：IUIAutomationElement*

與事件處理程式相關聯的UI Automation元素指標。

[in] scope

類型：TreeScope

要處理的事件範圍;也就是說，無論是在元素本身上，還是在其祖先和子代上。

[in] changeTypes

類型：int*

整數清單的指標，表示事件所代表的變更類型。

[in] changesCount

類型：int

此事件中發生的變更數目。

[in] pCacheRequest

類型：IUIAutomationCacheRequest*

快取要求的指標，如果不需要任何快取，則 NULL。

[in] handler

類型：IUIAutomationChangesEventHandler*

物件的指標，這個物件會處理變更事件。

傳回值

類型：HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

言論

Microsoft使用者介面自動化客戶端不應該使用多個線程來新增或移除事件處理程式。 如果在相同客戶端進程中新增或移除另一個事件處理程式，則非預期的行為可能會導致。

要求

要求 價值
最低支援的用戶端 Windows 10 版本 1607 [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2016 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 uiautomationclient.h （include UIAutomation.h）

另請參閱

IUIAutomation4

RemoveAllEventHandlers