EnumFontsProc

The EnumFontsProc function is an application-defined callback function that processes font data from the EnumFonts function. EnumFontsProc is a placeholder for the application-defined function name.

EnumFonts and EnumFontsProc are maintained for compatibility with 16-bit versions of Windows. Win32-based applications should call the EnumFontFamiliesEx 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

Pointer to a LOGFONT structure that contains information about the logical attributes of the font.

lptm

Pointer 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

Pointer 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.

Windows CE: Windows CE version 1.0 does not support TrueType fonts. In version 1.0, the value of the FontType parameter must be RASTER_FONTTYPE.

Windows CE Version 2.0 supports both TrueType and raster fonts. In version 2.0, FontType can have a value of either RASTER_FONTTYPE or TRUETYPE_FONTTYPE depending on the Windows CE platform. Any given Windows CE platform will support only raster fonts or TrueType fonts but not both.

See Also

Fonts and Text Overview, Font and Text Functions, EnumFonts, LOGFONT, TEXTMETRIC