通过

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

引用

重置

文本对象模型