ITextRange：：GetText 方法 (tom.h)

取得這個範圍中的純文本。 Text 屬性是 ITextRange 介面的預設屬性。

語法

HRESULT GetText(
  BSTR *pbstr
);

參數

pbstr

類型： BSTR*

文字。

傳回值

類型： HRESULT

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

備註

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。

規格需求

另請參閱

概念

複製

GetDuplicate

ITextRange

貼上

參考

文字物件模型