iTextFont::GetProtected 方法 (tom.h)

获取是否防止尝试修改字符。

语法

HRESULT GetProtected(
  long *pValue
);

参数

pValue

类型: long*

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

含义
tomTrue 字符受到保护。
tomFalse 字符不受保护。
tomUndefined Protected 属性未定义。

返回值

类型: HRESULT

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

返回代码 说明
E_INVALIDARG
无效的参数。
CO_E_RELEASED
字体对象附加到已删除的区域。

注解

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

要求

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

请参阅

概念性

CreateTextServices

CreateWindow

EN_PROTECTED

ITextFont

其他资源

引用

SetProtected

文本对象模型