CreateScalableFontResource
The CreateScalableFontResource
function creates a font resource file for a scalable font.
BOOL CreateScalableFontResource(
|
DWORD fdwHidden, |
// flag for
read-only embedded font |
|
LPCTSTR lpszFontRes, |
// pointer to
filename for font resource |
|
LPCTSTR lpszFontFile, |
// pointer to
filename for scalable font |
|
LPCTSTR lpszCurrentPath |
// pointer to path
to font file |
|
); |
|
Parameters
fdwHidden
Specifies
whether the font is a read-only embedded font. This parameter can be one of the
following values:
|
Value |
Meaning |
|
0 |
The font
has read-write permission. |
|
1 |
The font
has read-only permission and should be hidden from other applications in the
system. When this flag is set, the font is not enumerated by the EnumFonts or EnumFontFamilies function. |
lpszFontRes
Points to a
null-terminated string specifying the name of the font resource file that this
function creates.
lpszFontFile
Points to a
null-terminated string specifying the name of the scalable font file that this
function uses to create the font resource file.
lpszCurrentPath
Points to a
null-terminated string specifying the path to the scalable font file.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
The CreateScalableFontResource
function is used by applications that install TrueType fonts. An application
uses the CreateScalableFontResource function to create a font resource
file (typically with a .FOT filename extension) and then uses the AddFontResource function to install the
font. The TrueType font file (typically with a .TTF filename extension) must be
in the SYSTEM subdirectory of the WINDOWS directory to be used by the AddFontResource
function.
The CreateScalableFontResource
function currently supports only TrueType-technology scalable fonts.
When the lpszFontFile
parameter specifies only a filename and extension, the lpszCurrentPath
parameter must specify a path. When the lpszFontFile parameter specifies
a full path, the lpszCurrentPath parameter must be NULL or a pointer to
NULL.
When only a
filename and extension are specified in the lpszFontFile parameter and a
path is specified in the lpszCurrentPath parameter, the string in lpszFontFile
is copied into the .FOT file as the .TTF file that belongs to this resource.
When the AddFontResource
function is called, the operating system assumes that the .TTF file has been
copied into the SYSTEM directory (or into the main Windows directory in the
case of a network installation). The .TTF file need not be in this directory
when the CreateScalableFontResource function is called, because the lpszCurrentPath
parameter contains the directory information. A resource created in this manner
does not contain absolute path information and can be used in any Windows
installation.
When a path
is specified in the lpszFontFile parameter and NULL is specified in the lpszCurrentPath
parameter, the string in lpszFontFile is copied into the .FOT file. In
this case, when the AddFontResource function is called, the .TTF file
must be at the location specified in the lpszFontFile parameter when the
CreateScalableFontResource function was called; the lpszCurrentPath
parameter is not needed. A resource created in this manner contains absolute
references to paths and drives and does not work if the .TTF file is moved to a
different location.
See Also