CreateScalablefontResource()函数

函数功能:该函数为一种可升级的字体创建一个字体资源文件。

参数:

fdwHidden:指定此字体是否是一种嵌入式只读字体,此参数可取下列值之一:

0:此字体有读写权限。

1:此字体有只读权限,并且必须对系统的其他应用程序隐藏起来,当此值设置时,此字体不能被函数EnumFonts和EnumFontFamilies列举出来。

lpszFontRes:指向指定此函数创建的字体资源文件名字的,以结束的字符串的指针。

lpszfontFile:指向以结束的字符串的指针,该字符串指定用于创建字体资源文件的可升级字全文件的名字。

lpszCurrentPath:指向指定可升级字体文件路径的,以结束的字符串的指针。

返回值:如果函数调用成功,返回值非零;如果函数调用失败,返回值是0。

Windows NT:若想获得更多错误信息,请调用GetLastError函数。

备注:函数CreateScalableFontResource被那些安装TrueType字体的应用程序使用。一个应用程序可用CreateScalableFontResource来创建一个字体资源文件(通常有.FOT扩展名),然后用函数AddFontResource安装字体。TrueTpe字体文件(通常有.TTF扩展名)必须在WINDOWS目录下的SYSTEM子目录中,被函数AddFontResource使用。

CreateScalableFontResource目前只支持TrueType技术升级字体。

当参数lpszFontFile只指定一个文件名和扩展名时,lpszCurrentPath必须指定一个路径。

当参数lpszFontFile指定了一个完整的路径,则lpszCurrentPath必须为NULL,或者为指向NULL的指针。

当参数lpszFontFile指定了一个文件名和扩展名,且lpszCurrentPath中指定路径时,在lpszFontFile中的字符串被拷贝到.FOT文件,象属于此资源的.TTF一样。当AddFontResource被调用时,操作系统假定.TTF文件被拷贝到SYSTEM目录下(或者有网络安装的情况下到主Windows目录下)。当CreateScalableFontResource被调用时,.TTF文件不必在这个目录下,因为lpszCurrentPath包含了目录信息,在这种情况下创建的资源不包含绝对路径,可以被任意安装使用。

当lpszFontFile指定了路径,且lpszCurrentPath被指定为NULL,则在lpszFontFile中的字符串被拷贝到.FOT文件,在这种情况下,当函数AddFontResource被调用时,.TTF文件必须在参数lpszFontFile指定的位置处,当CreateScalableFontResource调用时,lpszCurrentPath参数不需要,这种情况下创建的资源含有对路径和驱动器的绝对访问,当.TTF被移到不同的位置时,就不能使用。

速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:不支持;头文件:wingdi.h;库文件:gdi32.lib;Unicode:在Windows NT环境下以Unicode和ANSI两种方式实现。