EnumFontsProc
The EnumFontsProc
function is an application-defined callback function that processes font data
from the EnumFonts
function.
int CALLBACK EnumFontsProc(
|
lplf lplf, |
// pointer to
logical-font data |
|
lptm lptm, |
// pointer to
physical-font data |
|
DWORD dwType, |
// font type |
|
LPARAM lpData |
// pointer to
application-defined data |
|
); |
|
Parameters
lplf
Points to a LOGFONT structure that contains
information about the logical attributes of the font.
lptm
Points to a TEXTMETRIC structure that contains
information about the physical attributes of the font.
dwType
Specifies the
type of the font. This parameter can be a combination of the following values:
DEVICE_FONTTYPE
RASTER_FONTTYPE
TRUETYPE_FONTTYPE
lpData
Points to the
application-defined data passed by EnumFonts.
Return Values
The return
value must be a nonzero value to continue enumeration; to stop enumeration, it
must be zero.
Remarks
The AND
(&) operator can be used with the RASTER_FONTTYPE and DEVICE_FONTTYPE
constants to determine the font type. The RASTER_FONTTYPE bit of the FontType
parameter specifies whether the font is a raster or vector font. If the bit is
one, the font is a raster font; if zero, it is a vector font. The
DEVICE_FONTTYPE bit of FontType specifies whether the font is a
device-based or graphics device interface (GDI)-based font. If the bit is one,
the font is a device-based font; if zero, it is a GDI-based font.
If the device
is capable of text transformations (scaling, italicizing, and so on) only the
base font is enumerated. The user must inquire into the device s
text-transformation abilities to determine which additional fonts are available
directly from the device.
An
application must register the EnumFontsProc function by passing its
address to the EnumFonts function.
EnumFontsProc is a placeholder for the application-defined function
name.
See Also