This function creates a logical font that has the characteristics specified in the specified structure. The font can subsequently be selected as the current font for any device context (DC).
At a Glance
| Header file: | Wingdi.h |
| Windows CE versions: | 1.0 and later |
Syntax
HFONT CreateFontIndirect(const LOGFONT *lplf);
Parameters
lplf
[in] Long pointer to a LOGFONT structure that defines the characteristics of the logical font.
Return Values
A handle to a logical font indicates success. NULL indicates failure. To get extended error information, call GetLastError.
Remarks
The CreateFontIndirect function creates a logical font with the characteristics specified in the LOGFONT structure. When this font is selected by using the SelectObject function, GDI’s font mapper attempts to match the logical font with an existing physical font. If it fails to find an exact match, it provides an alternative whose characteristics match as many of the requested characteristics as possible.
When you no longer need the font, call the DeleteObject function to delete it.
Windows CE versions 2.0 and later support systems that use either TrueType or raster fonts but not both. The font type (raster or TrueType) is chosen at system design time, and cannot be changed by an application.
Windows CE versions 1.0 and 1.01 support only raster fonts.
See Also