CreateFontIndirect

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

HFONT
CreateFontIndirect( const
LOGFONT
*
lplf
);

Parameters

lplf

[in] Long pointer to a LOGFONTstructure 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 CreateFontIndirectfunction creates a logical font with the characteristics specified in the LOGFONTstructure. When this font is selected by using the SelectObjectfunction, 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 DeleteObjectfunction 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.

Requirements

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

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.