共用方式為


ITextRange::SetText 方法 (tom.h)

設定此範圍中的文字。

語法

HRESULT SetText(
  [in] BSTR bstr
);

參數

[in] bstr

類型: BSTR

取代此範圍中目前文字的文字。 如果為 null,則會刪除目前的文字。

傳回值

類型: HRESULT

方法會傳回 HRESULT 值。 如果方法成功,它會 傳回S_OK。 如果方法失敗,它會傳回下列其中一個錯誤碼。 如需 COM 錯誤碼的詳細資訊,請參閱 COM 中的錯誤處理

傳回碼 Description
E_ACCESSDENIED
文字受到寫入保護。
E_INVALIDARG
bstr 為 null。
E_OUTOFMEMORY
記憶體不足。

備註

ITextRange::SetText 會將範圍中的文字取代為新的文字。 相反地, TypeText 會將選取範圍取代為 文字 bstr ,並將選取範圍保留為緊接在插入文字後面的插入點,就像您輸入文字一樣。 如需 UI 選取行為,請參閱 TypeText

如果您在呼叫 ITextRange::SetText之後呼叫 ITextRange::GetText,您會取得與 ITextRange::SetText 方法一起設定的相同文字 (,除非某些其他範圍已在呼叫) 之間變更該文字。

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 tom.h
Dll Msftedit.dll

另請參閱

概念

GetText

ITextRange

參考

文字物件模型

TypeText