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::CopyITextRange::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

粘贴

引用

文本对象模型