Gdi::EnumFontFamiliesW_I

  • Article

This method enumerates the fonts in a specified font family that are available on a specified device. This function supersedes the Gdi::EnumFontsW_I method.

static WINGDIAPI int WINAPI EnumFontFamiliesW_I(
  HDC hdc,
  const WCHAR* lpszFamily, 
  FONTENUMPROC lpEnumFontFamProc, 
  LPARAM lParam
);

Parameters

  • hdc
    [in] Handle to the device context.
  • lpszFamily
    [in] Long pointer to a null-terminated string that specifies the family name of the desired fonts. If lpszFamily is NULL, Gdi::EnumFontFamiliesW_I randomly selects and enumerates one font of each available type family.
  • lpEnumFontFamProc
    [in] Long pointer to the procedure-instance address of the application-defined callback function. For information about the callback function, see EnumFontFamProc.
  • lParam
    [in] Pointer to application-supplied data. The data is passed to the callback function along with the font information.

Return Values

The return value is the last value returned by the callback function. The meaning of this value is defined by the application.

Remarks

This method is an internal version of the EnumFontFamilies function.

For each font having the typeface name specified by the lpszFamily parameter, the Gdi::EnumFontFamiliesW_I method retrieves information about that font and passes that information to the function pointed to by the lpEnumFontFamProc parameter. The application-defined callback function can process the font information as desired. Enumeration continues until no fonts remain or the callback function returns zero.

Windows 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

OS Versions: Windows CE .NET 4.0 and later.
Header: Gdi.hpp.

See Also

EnumFontFamilies | EnumFontFamProc | Gdi::EnumFontsW_I

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.