UiaRaiseTextEditTextChangedEvent 函式 (uiautomationcoreapi.h)
由提供者呼叫,通知 Microsoft 使用者介面自動化 核心文字控件已以程式設計方式變更文字。
語法
HRESULT UiaRaiseTextEditTextChangedEvent(
[in] IRawElementProviderSimple *pProvider,
[in] TextEditChangeType textEditChangeType,
[in] SAFEARRAY *pChangedData
);
參數
[in] pProvider
類型: IRawElementProviderSimple*
發生文字變更的提供者節點。
[in] 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