EnumFonts
The EnumFonts
function enumerates the fonts available on a specified device. For each font
with the specified typeface name, the EnumFonts function retrieves
information about that font and passes it to the application-defined callback
function. This callback function can process the font information as desired.
Enumeration continues until there are no more fonts or the callback function
returns zero.
This function
is provided for compatibility with earlier versions of Microsoft Windows.
Win32-based applications should use the EnumFontFamilies function.
int EnumFonts(
|
HDC hdc, |
// handle to device
context |
|
LPCTSTR lpFaceName, |
// pointer to font
typeface name string |
|
FONTENUMPROC lpFontFunc, |
// pointer to
callback function |
|
LPARAM lParam |
// address of
application-supplied data |
|
); |
|
Parameters
hdc
Identifies
the device context.
lpFaceName
Points to a
null-terminated character string that specifies the typeface name of the
desired fonts. If lpFaceName is NULL, EnumFonts randomly selects
and enumerates one font of each available typeface.
lpFontFunc
Points to the
application-defined callback function. For more information about the callback
function, see the EnumFontsProc function.
lParam
Points to any
application-defined data. The data is passed to the callback function along
with the font information.
Return Values
If the
function succeeds, the return value is the last value returned by the callback
function. Its meaning is defined by the application.
Remarks
Use EnumFontFamilies
instead of EnumFonts. The EnumFontFamilies function differs from
the EnumFonts function in that it retrieves the style names associated
with a TrueType font. With EnumFontFamilies, you can retrieve
information about unusual font styles (for example, Outline) that cannot be
enumerated using the EnumFonts function.
See Also