共用方式為


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_BSTRVAR

傳回值

類型: HRESULT

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

備註

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

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

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

  • TextEditChangeType_AutoCorrectpChangedData 應該是新的更正字串 。
  • TextEditChangeType_CompositionpChangedData 應該是組合中更新的字串串, (變更) 的部分。
  • TextEditChangeType_CompositionFinalizedpChangedData 應該是已完成組合的完成字串串, (如果組合已取消或刪除,則此字串可能是空的) 。

規格需求

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

另請參閱

HandleTextEditTextChangedEvent

ITextEditProvider

IUIAutomation3::AddTextEditTextChangedEventHandler

TextEdit 控制件模式