Gdi::EnumFontsW_I (Windows Embedded CE 6.0)

1/6/2010

This method enumerates the fonts available on a specified device. This method is provided for compatibility with earlier versions of the Microsoft Windows SDK. Whenever possible, applications should use the Gdi::EnumFontFamiliesW_I method.

Syntax

static WINGDIAPI int WINAPI EnumFontsW_I(
  HDC hdc,
  const WCHAR* lpFaceName,
  FONTENUMPROC lpFontFunc,
  LPARAM lParam
);

Parameters

• hdc
  [in] Handle to the device context.

• lpFaceName
  [in] Long pointer to a null-terminated string that specifies the typeface name of the desired fonts.

  If lpFaceName is NULL, Gdi::EnumFontsW_I randomly selects and enumerates one font of each available typeface.

• lpFontFunc
  [in] Long pointer to the application-defined callback function.

  For more information, see EnumFontsProc.

• lParam
  [in] Pointer to any application-defined data.

  The data is passed to the callback function along with the font information.

Return Value

The return value is the last value returned by the callback function.

The meaning of this value is defined by the application.

Remarks

The method is an internal version of the EnumFonts function.

Use Gdi::EnumFontFamiliesW_I instead of Gdi::EnumFontsW_I. The Gdi::EnumFontFamiliesW_I method differs from the Gdi::EnumFontsW_I method in that Gdi::EnumFontFamiliesW_I retrieves the style names associated with a TrueType font.

With Gdi::EnumFontFamiliesW_I, you can retrieve information about font styles that cannot be enumerated using the Gdi::EnumFontsW_I function.

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

See Also

Reference

Gdi
Gdi::EnumFontFamiliesW_I
Gdi::GetDeviceCaps_I

Other Resources

EnumFonts
EnumFontsProc