Share via

EnumFontsProc

  • Article

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

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

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Wingdi.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

EnumFonts, LOGFONT, TEXTMETRIC

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.