ITextRange::SetText 方法 (tom.h)
設定此範圍中的文字。
語法
HRESULT SetText(
[in] BSTR bstr
);
參數
[in] bstr
類型: BSTR
取代此範圍中目前文字的文字。 如果為 null,則會刪除目前的文字。
傳回值
類型: HRESULT
方法會傳回 HRESULT 值。 如果方法成功,它會 傳回S_OK。 如果方法失敗,它會傳回下列其中一個錯誤碼。 如需 COM 錯誤碼的詳細資訊,請參閱 COM 中的錯誤處理。
傳回碼 | Description |
---|---|
|
文字受到寫入保護。 |
|
bstr 為 null。 |
|
記憶體不足。 |
備註
ITextRange::SetText 會將範圍中的文字取代為新的文字。 相反地, TypeText 會將選取範圍取代為 文字 bstr ,並將選取範圍保留為緊接在插入文字後面的插入點,就像您輸入文字一樣。 如需 UI 選取行為,請參閱 TypeText。
如果您在呼叫 ITextRange::SetText之後呼叫 ITextRange::GetText,您會取得與 ITextRange::SetText 方法一起設定的相同文字 (,除非某些其他範圍已在呼叫) 之間變更該文字。
規格需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | tom.h |
Dll | Msftedit.dll |
另請參閱
概念
參考