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 中的错误处理。
返回代码 | 说明 |
---|---|
|
无效的参数。 |
|
字体对象附加到已删除的区域。 |
|
写入访问被拒绝。 |
|
内存不足。 |
注解
通常,文本对象模型 (TOM) 尝试更改区域的格式或内容的方法将失败 ,如果该区域 的任何部分受保护或文档是只读的,则E_ACCESSDENIED。 若要对受保护的文本进行更改,TOM 客户端应尝试关闭对要修改的文本的保护。 文档的所有者可能允许这种情况发生。 例如,在富编辑控件中,尝试更改受保护的文本会导致向文档创建者 EN_PROTECTED 通知代码,然后创建者可以拒绝或授予更改权限。 创建者是通过 CreateWindow 函数或调用 CreateTextServices 函数创建无窗口富编辑控件的 ITextHost 对象创建窗口式富编辑控件的客户端。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | tom.h |
DLL | Msftedit.dll |
请参阅
概念性
其他资源
引用