描述
AddFontResourceEx功能将字体资源从指定的文件添加到系统。使用AddFontResourceEx功能添加的字体可以标记为私有，不能枚举。
C++ 语法
int AddFontResourceEx( __in LPCTSTR lpszFilename, __in DWORD fl, __in PVOID pdv ); |
PowerBASIC 语法
FUNCTION AddFontResourceExA ( _ BYREF lpszFilename AS ASCIIZ, _ BYVAL fl AS DWORD, _ BYVAL pdv AS DWORD _ ) AS LONG |
Unicode版本:
FUNCTION AddFontResourceExW ( _ BYREF lpszFilename AS WSTRINGZ, _ BYVAL fl AS DWORD, _ BYVAL pdv AS DWORD _ ) 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文件一起使用。 |
要添加其信息来自多个资源文件的字体，请将lpszFileName指向一个字符串，文件名称由| - 例如abcxxxxx.pfm | abcxxxxx.pfb。
fl
[in]指定要添加到系统的字体的特征。此参数可以是以下值之一。
值 |
含义 |
FR_PRIVATE |
指定只有调用AddFontResourceEx函数的进程可以使用此字体。当字体名称与公共字体匹配时，将选择专用字体。当进程终止时，系统将使用AddFontResourceEx功能删除进程安装的所有字体。 |
FR_NOT_ENUM |
指定没有进程，包括调用AddFontResourceEx函数的进程可以枚举此字体。 |
pdv
[in]保留。必须为零。
返回值
如果函数成功，则返回值指定添加的字体数。
如果函数失败，返回值为零。没有扩展错误信息可用。
备注
此函数允许进程使用字体，而不允许其他进程访问字体。
当应用程序不再需要通过调用AddFontResourceEx功能加载的字体资源时，它必须通过调用RemoveFontResourceEx功能来删除资源。
此函数仅为当前会话安装字体。系统重新启动时，字体将不存在。即使在重新启动系统后也要安装字体，字体必须在注册表中列出。
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）