IUIAutomation3：：AddTextEditTextChangedEventHandler 方法 (uiautomationclient.h)

發行項
03/03/2024

註冊處理程式設計文字編輯事件的方法。

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

語法

HRESULT AddTextEditTextChangedEventHandler(
  [in] IUIAutomationElement                         *element,
  [in] TreeScope                                    scope,
  [in] TextEditChangeType                           textEditChangeType,
  [in] IUIAutomationCacheRequest                    *cacheRequest,
  [in] IUIAutomationTextEditTextChangedEventHandler *handler
);

參數

[in] element

類型： IUIAutomationElement*

與事件處理程式相關聯之使用者介面自動化專案的指標。

[in] scope

類型： TreeScope

要處理的事件範圍，意即，事件是項目本身或其項目的祖系及子系。

[in] textEditChangeType

類型： TextEditChangeType

要接聽的特定變更類型。用戶端會分別註冊每個文字編輯變更類型，讓使用者介面自動化系統可以在運行時間檢查已註冊的接聽程式，並避免在沒有任何接聽程式時引發特定文字編輯變更的事件。

[in] cacheRequest

類型： IUIAutomationCacheRequest*

快取要求的指標，如果沒有想要快取，則為 NULL 。

[in] handler

類型： IUIAutomationTextEditTextChangedEventHandler*

物件的指標，可處理程序設計文字編輯事件。

傳回值

類型： HRESULT

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

備註

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

規格需求

需求	值
最低支援的用戶端	Windows 8.1 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 R2 [僅限傳統型應用程式]
目標平台	Windows
標頭	uiautomationclient.h (包含 UIAutomation.h)