EnumFontsProc

This function is an application-defined callback function that processes font data from the EnumFonts function.

At a Glance

Header file:	Wingdi.h
Windows CE versions:	1.0 and later

Syntax

int CALLBACK EnumFontsProc(lplf lplf, lptm lptm, DWORD dwType, LPARAM lpData);

Parameters

lplf

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

lptm

[out] Pointer to a TEXTMETRIC structure that contains information about the physical attributes of the font.

dwType

[in] Specifies the type of the font. This parameter can be a combination of the following values:

DEVICE_FONTTYPE

RASTER_FONTTYPE

TRUETYPE_FONTTYPE

lpData

[in] Long pointer to the application-defined data passed by EnumFonts.

Return Values

Nonzero continues enumeration. Zero stops enumeration.

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 versions 1.0 and 1.01 does not support TrueType fonts. In version 1.0, the value of the FontType parameter must be RASTER_FONTTYPE.

Windows CE versions 2.0 and later support 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.