iTextFont::Reset 方法 (tom.h)

将字符格式重置为指定的值。

语法

HRESULT Reset(
  [in] long Value
);

参数

[in] Value

类型: long

重置的类型。 此参数可以是以下值的组合。

含义
tomDefault
如果此字体对象附加到某个区域,则设置为文档默认字符格式;否则,将 默认值设置为基本 TOM 引擎默认值。
tomUndefined
将所有属性设置为未定义的值。 此值仅对重复 (克隆) 字体对象有效。
tomApplyLater
允许设置属性值,但不要将它们应用于附加的范围。
tomApplyNow
将当前属性应用于附加范围。
tomCacheParms
不要使用附加的范围属性更新当前字体。
tomTrackParms
使用附加的范围属性更新当前字体。
tomApplyTmp
应用临时格式。
tomDisableSmartFont
不要应用智能字体。
tomEnableSmartFont
应用智能字体。
tomUsePoints
使用点进行浮点度量。
tomUseTwips
使用缇进行浮点度量。

返回值

类型: HRESULT

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

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

注解

使用 tomUndefined 调用 ITextFont::Reset 会将所有属性设置为未定义的值。 因此,将字体对象应用于区域不会更改任何内容。 这适用于通过 ITextFont::GetDuplicate 方法获取的字体对象。

要求

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

请参阅

概念性

GetDuplicate

ITextFont

引用

文本对象模型