Share via

CreateFontIndirect

  • Article

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 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, GDIs 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.

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.

See Also

DeleteObject, GetLastError, SelectObject, LOGFONT

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.