Share via


Gdi::CreateFontIndirectW_I (Windows Embedded CE 6.0)

1/6/2010

This method creates a logical font that has the characteristics specified in the specified LOGFONT structure. You can subsequently select the font as the current font for any device context.

Syntax

static WINGDIAPI HFONT WINAPI CreateFontIndirectW_I(
  const LOGFONT* lplf
);

Parameters

  • lplf
    [in] Long pointer to a LOGFONT structure that defines the characteristics of the logical font.

Return Value

A handle to a logical font indicates success.

NULL indicates failure.

To get extended error information, call GetLastError.

Remarks

This method is an internal version of the CreateFontIndirect function.

The Gdi::CreateFontIndirectW_I method creates a logical font with the characteristics specified in the LOGFONT structure.

When you select this font by using the Gdi::SelectObject_I method, the font mapper for GDI attempts to match the logical font with an existing physical font.

If the font mapper fails to find an exact match, the font mapper provides an alternative, the characteristics of which match as many of the requested characteristics as possible.

When you no longer need the font, call the Gdi::DeleteObject_I method to delete the font.

Windows Embedded CE supports 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.

Requirements

Header gdi.hpp
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

Gdi
Gdi::DeleteObject_I
Gdi::SelectObject_I

Other Resources

CreateFontIndirect
LOGFONT