EnumFonts

  int EnumFonts(hdc, lpFaceName, lpFontFunc, lParam)    
  HDC hdc;    
  LPCTSTR lpFaceName;    
  FONTENUMPROC lpFontFunc;    
  LPARAM lParam;    

The EnumFonts function enumerates the fonts available on a given device. For each font having the typeface name specified by the lpFaceName parameter, the EnumFonts function retrieves information about that font and passes it to the function pointed to by the lpFontFunc parameter. The application-supplied callback function can process the font information as desired. Enumeration continues until there are no more fonts or the callback function returns zero.

Parameters

hdc

Identifies the device context.

lpFaceName

Points to a null-terminated character string that specifies the typeface name of the desired fonts. If lpFaceName is NULL, EnumFonts randomly selects and enumerates one font of each available typeface.

lpFontFunc

Is the address of the callback function. For more information about the callback function, see the description of the EnumFontsProc callback function.

lParam

Points to the application-supplied data. The data is passed to the callback function along with the font information.

Return Value

The return value specifies the last value returned by the callback function. Its meaning is user defined.

Comments

The EnumFonts function may be used as either a wide-character function (where text arguments must use Unicode) or an ANSI function (where text arguments must use characters from the Windows 3.x character set

See Also

GetDeviceCaps