UiaRaiseTextEditTextChangedEvent 函式 (uiautomationcoreapi.h)

由提供者呼叫，通知 Microsoft 使用者介面自動化 核心文字控件已以程式設計方式變更文字。

語法

HRESULT UiaRaiseTextEditTextChangedEvent(
  [in] IRawElementProviderSimple *pProvider,
  [in] TextEditChangeType        textEditChangeType,
  [in] SAFEARRAY                 *pChangedData
);

參數

[in] pProvider

類型： IRawElementProviderSimple*

發生文字變更的提供者節點。

[in] textEditChangeType

類型： TextEditChangeType

發生的文字編輯變更類型。

[in] pChangedData

類型： SAFEARRAY*

事件資料。 應可指派為類型為 VT_BSTR的 VAR。

傳回值

類型： HRESULT

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

備註

這是實作 ITextEditProvider 之提供者的協助程式函式，並引發模式的必要事件。 請遵循 TextEdit 控制項模式中提供的指引，說明何時引發事件，以及事件應該傳遞至 使用者介面自動化 的承載。

如果沒有用戶端接聽特定變更類型，則不會引發任何事件。

每個 TextEditChangeType (每個變更類型) 的事件數據都應該包含不同的承載：

• TextEditChangeType_AutoCorrect： pChangedData 應該是新的更正字串 。
• TextEditChangeType_Composition： pChangedData 應該是組合中更新的字串串， (變更) 的部分。
• TextEditChangeType_CompositionFinalized： pChangedData 應該是已完成組合的完成字串串， (如果組合已取消或刪除，則此字串可能是空的) 。

規格需求

需求	值
最低支援的用戶端	Windows 8.1 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2012 R2 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	uiautomationcoreapi.h
程式庫	Uiautomationcore.lib
Dll	Uiautomationcore.dll

另請參閱

HandleTextEditTextChangedEvent

ITextEditProvider

IUIAutomation3：：AddTextEditTextChangedEventHandler

TextEdit 控制件模式