iTextRange::GetText 方法 (tom.h)
获取此区域中的纯文本。 Text 属性是 ITextRange 接口的默认属性。
语法
HRESULT GetText(
BSTR *pbstr
);
参数
pbstr
类型: BSTR*
文本。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 如果方法失败,它将返回以下错误代码之一。 有关 COM 错误代码的详细信息,请参阅 COM 中的错误处理。
返回代码 | 说明 |
---|---|
|
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 中读取其他选项。 嵌入对象的占位符由特殊字符 WCH_EMBEDDING提供,该字符具有0xFFFC Unicode 值。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | tom.h |
DLL | Msftedit.dll |
请参阅
概念性
引用