AddFontResource

描述

AddFontResource函数将字体资源从指定的文件添加到系统字体表。该字体随后可用于任何应用程序的文本输出。

要将字体标记为私有或不可列举，请使用AddFontResourceEx功能。

C++ 语法

int AddFontResource(

__in LPCTSTR lpszFilename

);

PowerBASIC 语法

FUNCTION AddFontResourceA ( _

BYREF lpszFilename AS ASCIIZ _

) AS LONG

Unicode版本:

FUNCTION AddFontResourceW ( _

BYREF lpszFilename AS WSTRINGZ _

) AS LONG

参数

lpszFilename

[in]指向包含有效字体文件名的空值终止字符串的指针。此参数可以指定以下任何文件。

文件扩展名	描述
.FON	字体资源文件。
.FNT	原始位图字体文件。
.TTF	Raw TrueType文件。
.ttcen	东亚Windows：TrueType字体集合。
.FOT	TrueType资源文件。
杂项文件	PostScript OpenType字体。
.mmm	多主控Type1字体资源文件。它必须与.pfm和.pfb文件一起使用。
.PFB	类型1字体位文件。它与.pfm文件一起使用。
.PFM	类型1字体指标文件。它与.pfb文件一起使用。

Windows 2000 / XP / Vista / Windows 7：要添加其信息来自多个资源文件的字体，请lpszFileName指向一个字符串，文件名称由| - 例如abcxxxxx.pfm | abcxxxxx.pfb。

返回值

如果函数成功，则返回值指定添加的字体数。

如果函数失败，返回值为零。没有扩展错误信息可用。

备注

任何从系统字体表中添加或删除字体的应用程序都应通过向操作系统中的所有顶级窗口发送WM_FONTCHANGE消息来通知其他窗口。应用程序应通过调用SendMessage功能并将hwnd参数设置为HWND_BROADCAST来发送此消息。

当应用程序不再需要通过调用AddFontResource函数加载的字体资源时，它必须通过调用RemoveFontResource函数来删除该资源。

此函数仅为当前会话安装字体。系统重新启动时，字体将不存在。即使在重新启动系统后也要安装字体，字体必须在注册表中列出。

Windows 95/98 / Me：Microsoft Layer for Unicode支持AddFontResourceW.

引用文件 #INCLUDE Once

WinGdi.inc（包括Windows.inc）