iTextFont::SetProtected 方法 (tom.h)

设置是否防止尝试修改字符。

语法

HRESULT SetProtected(
  [in] long Value
);

参数

[in] Value

类型: long

一个 tomBool 值,可以是下列值之一。

含义
tomTrue 字符受到保护。
tomFalse 字符不受保护。
tomToggle 切换 Protected 属性的状态。
tomUndefined 未定义 Protected 属性。

返回值

类型: HRESULT

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

返回代码 说明
E_INVALIDARG
无效的参数。
CO_E_RELEASED
字体对象附加到已删除的区域。
E_ACCESSDENIED
写入访问被拒绝。
E_OUTOFMEMORY
内存不足。

注解

通常,文本对象模型 (TOM) 尝试更改区域的格式或内容的方法将失败 ,如果该区域 的任何部分受保护或文档是只读的,则E_ACCESSDENIED。 若要对受保护的文本进行更改,TOM 客户端应尝试关闭对要修改的文本的保护。 文档的所有者可能允许这种情况发生。 例如,在富编辑控件中,尝试更改受保护的文本会导致向文档创建者 EN_PROTECTED 通知代码,然后创建者可以拒绝或授予更改权限。 创建者是通过 CreateWindow 函数或调用 CreateTextServices 函数创建无窗口富编辑控件的 ITextHost 对象创建窗口式富编辑控件的客户端。

要求

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

请参阅

概念性

CreateTextServices

CreateWindow

EN_PROTECTED

GetProtected

ITextFont

其他资源

引用

文本对象模型