ITextRange::SetText 方法 (tom.h)

设置此区域中的文本。

语法

HRESULT SetText(
  [in] BSTR bstr
);

参数

[in] bstr

类型: BSTR

替换此区域中当前文本的文本。 如果为 null,则删除当前文本。

返回值

类型: HRESULT

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

返回代码 说明
E_ACCESSDENIED
文本受写保护。
E_INVALIDARG
bstr 为 null。
E_OUTOFMEMORY
内存不足。

注解

ITextRange::SetText 将区域中的文本替换为新文本。 相比之下, TypeText 将所选内容替换为文本 bstr ,并将所选内容保留为插入点,就像键入文本一样。 有关 UI 选择行为,请参阅 TypeText

如果在调用 ITextRange::SetText 之后调用 ITextRange::GetText,则返回使用 ITextRange::SetText 方法 (设置的相同文本,除非其他某个区域在调用) 之间更改了该文本。

要求

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

请参阅

概念性

GetText

ITextRange

引用

文本对象模型

TypeText