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