iTextRange::SetFont 方法 (tom.h)

将此范围的字符属性设置为指定 ITextFont 对象的字符属性。

语法

HRESULT SetFont(
  [in] ITextFont *pFont
);

参数

[in] pFont

类型: ITextFont*

具有所需字符格式的字体对象。

返回值

类型: HRESULT

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

返回代码 说明
含义
E_ACCESSDENIED
文本受到保护。
E_INVALIDARG
pFont 为 null。
E_OUTOFMEMORY
内存不足。

注解

对于偶尔的格式更改,请使用 ITextRange::SetFont 方法。 但是,若要进行大量字符格式更改,使用重复字体会更有效。 这是因为每次执行 语句(如 range.font.bold = tomTrue)时,都会分配并释放字体对象。 但是,重复字体可以分配一次并多次使用。 此外,还可以保存重复字体,使用 Reset 方法将其重置为默认或未定义状态,并根据需要为其指定格式文本处理值。 有关演示如何使用重复字体的示例代码,请参阅 使用重复字体

要求

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

请参阅

概念性

ITextRange

引用

重置

文本对象模型