iTextRange：：GetText 方法 (tom.h)

获取此区域中的纯文本。 Text 属性是 ITextRange 接口的默认属性。

语法

HRESULT GetText(
  BSTR *pbstr
);

参数

pbstr

类型： BSTR*

文本。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 如果方法失败，它将返回以下错误代码之一。 有关 COM 错误代码的详细信息，请参阅 COM 中的错误处理。

返回代码	说明
E_INVALIDARG	pbstr 为 null。
E_OUTOFMEMORY	内存不足，无法容纳文本。

注解

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 中读取其他选项。 嵌入对象的占位符由特殊字符 WCH_EMBEDDING提供，该字符具有0xFFFC Unicode 值。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	tom.h
DLL	Msftedit.dll

请参阅

概念性

复制

GetDuplicate

ITextRange

粘贴

引用

文本对象模型