ITextRange：：GetText 方法 (tom.h)
取得這個範圍中的純文本。 Text 屬性是 ITextRange 介面的預設屬性。
語法
HRESULT GetText(
BSTR *pbstr
);
參數
pbstr
類型： BSTR*
文字。
傳回值
類型： HRESULT
如果方法成功，它會 傳回S_OK。 如果方法失敗，它會傳回下列其中一個錯誤碼。 如需 COM 錯誤碼的詳細資訊，請參閱 COM 中的錯誤處理。
| 傳回碼 | Description |
|---|---|
|
pbstr 為 null。 |
|
記憶體不足，無法保存文字。 |
備註
ITextRange：：GetText 方法會傳回範圍內的純文本。 Text 屬性是 ITextRange 的預設屬性;這是針對某個範圍自動叫用，如下列 Microsoft Visual Basic for Applications (VBA) 範例所示。
print range
下列部分範例會使用此事實。 ITextRange：：SetText 方法會以 bstr 取代範圍文字。 為了處理單一字元，Char 屬性比 Text 屬性更有效率，而且不需要建立單一字元範圍來儲存字元。 如果範圍變質，Text 屬性可讓您輕鬆地插入文字。 您也可以刪除範圍中的文字，如下列 VBA 範例所示。
range.delete
range = ""
您可以使用 Text 屬性，將純文字從一個位置複製到另一個位置，只要將某個範圍設定為另一個範圍即可。 (這與 Duplicate 屬性相當不同;如需詳細資訊，請參閱 ITextRange：：GetDuplicate) 。 下列 Microsoft Visual Basic 範例語句會將 range1 中的文字設定為 range2 中的文字。
range1 = range2 ' Replace range1's text by range2's
範圍可以位於不同的劇本中，甚至是在不同的應用程式中。 不過，它們確實會先將文字複製到 BSTR ，然後從該字串複製到目標位置。 對於大量文字， ITextRange：：Copy 和 ITextRange：:P aste 方法可能更快，因為它們可以直接從來源複製到目標，以及來源和目標支援的任何格式來執行複製。
Text 屬性所傳回的文字是以 Unicode 提供。 視源檔而定，0x2029 (Unicode 段落分隔符) 或歸位字元/換行字元 (CR/LF) (0xd、0xa) 或单独使用归位字符来指定段落结尾标记。 Microsoft Word 單獨使用歸位字元，除非它從檔案、剪貼簿或 IDataObject 讀取另一個選項。 內嵌物件的佔位元是由具有 Unicode 值的特殊字元 WCH_EMBEDDING所指定0xFFFC。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | tom.h |
| Dll | Msftedit.dll |
另請參閱
概念
參考