Retrieving Font Styles Using EnumFontFamilies()

• Microsoft Windows Software Development Kit (SDK) for Windows version 3.1
• Microsoft Win32 Application Programming Interface (API) included with:

      - Microsoft Windows NT versions 3.5 and 3.51
      - Microsoft Windows 95 version 4.0
  

SUMMARY

Windows version 3.1 introduces the concept of a font style. In previous versions of Windows, a font could have the bold, italic, underline, and strikeout properties, which were supported by respective members in the LOGFONT and TEXTMETRIC structures. Windows 3.1 also supports these properties, as well as a style name for TrueType fonts. The article describes how to obtain the font style name during font enumeration, using the EnumFontFamilies function. For more information about obtaining style information without enumerating the fonts, query on the following words in the Microsoft Knowledge Base:

   prod(winsdk) and getoutlinetextmetrics

MORE INFORMATION

In Windows 3.1, "style" refers to the weight and slant of a font. Windows supports a wide range of weights in the lfWeight member of the LOGFONT structure. (Two examples of weights are FW_BOLD, which is defined as 700, and FW_THIN, which is defined as 100). Very few applications, however, use any weights other than FW_BOLD and FW_DONTCARE (defined as 0).

Windows 3.1 builds on the support presently in Windows for these variations in weight and slant. Style names are NOT used in the LOGFONT structure except when the fonts are enumerated with EnumFontFamilies.

The ChooseFont dialog box in the common dialog boxes dynamic-link library (COMMDLG.DLL) demonstrates how style names are used. The ChooseFont dialog box has two list boxes: Font and Font Style. The Font list box lists the face names for all fonts installed and the Font Style list box lists the font styles for the currently selected face. For example, if any non-TrueType font (such as MS Sans Serif) is selected, the following styles appear in the Font Style list box:

   Regular
   Bold
   Italic
   Bold Italic

   Regular
   Italic
   Demibold Roman
   Demibold Italic

In Windows 3.1, the EnumFontFamilies function can be used to obtain the style name of a font during font enumeration. The EnumFontFamilies function works in a manner very similar to the Windows 3.0 EnumFonts function.

EnumFontFamilies is prototyped as:

   int EnumFontFamilies(HDC hdc, LPCSTR lpszFamily,
                        FONTENUMPROC lpfnEnumProc, LPARAM lpData)

The following table illustrates the meanings of the terms, "typeface name," "font name," and "font style:"

   Typeface Name  Font Name                    Font Style
   -------------  ---------                    ----------

   Arial          Arial                        Regular
                  Arial Bold                   Bold
                  Arial Italic                 Italic
                  Arial Bold Italic            Bold Italic

   Courier New    Courier New                  Regular
                  Courier New Bold             Bold
                  Courier New Italic           Italic
                  Courier New Bold Italic      Bold Italic

   Lucida Sans    Lucida Sans                  Regular
                  Lucida Sans Italic           Italic
                  Lucida Sans Demibold Roman   Demibold Roman
                  Lucida Sans Demibold Italic  Demibold Italic

   MS Sans Serif  MS Sans Serif                Regular
                  MS Sans Serif                Bold
                  MS Sans Serif                Italic
                  MS Sans Serif                Bold Italic

When dealing with non-TrueType fonts, typeface name and font name are the same. However, it is important to recognize the distinction when dealing with a TrueType font.

For example, CreateFont takes a pointer to a string containing the typeface name of the font to create. It is not valid to use Arial Bold as this string because Arial is a TrueType font and Arial Bold is a font name, not a typeface name.

If EnumFontFamilies is called with the lpszFamily parameter pointing to a valid TrueType typeface name, the callback function, which is specified in fntenmprc, will be called once for each font name for that typeface name. For example, if EnumFontFamilies is called with lpszFamily pointing to Lucida Sans, the callback function will be called four times; once for each font name.

If the lpszFamily parameter points to the typeface name of a non- TrueType font, such as MS Sans Serif, the callback will be called once for each face size supported by the font. The number of face sizes supported by the font can vary from font to font and from device to device. Note that the callback is called for different sizes, not for different styles. This behavior is identical to that found using the EnumFonts function.

Remember that, because TrueType fonts are continuously scalable, there is no reason for the callback function to be called for each size. If the callback function was called for each size that a TrueType font supported, the callback function would be called an infinite number of times!

The EnumFontFamilies callback function is prototyped as follows:

int CALLBACK EnumFontFamProc(LPNEWLOGFONT lpnlf,
                             LPNEWTEXTMETRIC lpntm,
                             int FontType, LPARAM lpData)

   char   lfFullName[LF_FACESIZE*2];
   char   lfStyleName[LF_FACESIZE];

To retrieve the style name and full name of a font without using enumeration, use the GetOutlineTextMetrics function.