 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function is an application-defined callback function that processes font data from the EnumFontsfunction.
int CALLBACK EnumFontsProc( lplf lplf , lptm lptm , DWORD dwType , LPARAM lpData );
Parameters
- lplf
- [out] Pointer to a LOGFONTstructure that contains information about the logical attributes of the font.
- lptm
- [out] Pointer to a TEXTMETRICstructure 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 FontTypeparameter 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 FontTypespecifies 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 EnumFontsProcfunction by passing its address to the EnumFontsfunction.
Windows CE versions 1.0 and 1.01 does not support TrueType fonts. In version 1.0, the value of the FontTypeparameter must be RASTER_FONTTYPE.
Windows CE versions 2.0 and later support both TrueType and raster fonts. In version 2.0, FontTypecan 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