Retrieving the Style String for a TrueType Font

• 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 bold, italic, underline, and strikeout properties, which were supported by corresponding members of the LOGFONT and TEXTMETRIC structures. Windows 3.1 continues to support these properties, however, it also supports the concept of a style name for TrueType fonts.

Windows use of style names can be demonstrated by the ChooseFont dialog box in the common dialog boxes dynamic-link library (COMMDLG.DLL). The ChooseFont dialog box contains two list boxes named Font and Font Style. The Font list box contains a list of all face names and the Font Style list box contains a list of font styles for the currently selected face. For example, if any non-TrueType font (such as MS Sans Serif) is selected, the following styles will appear in the style list box:

   Regular
   Bold
   Italic
   Bold Italic

   Regular
   Italic
   Demibold Roman
   Demibold Italic

MORE INFORMATION

As part of the TrueType support, the GetOutlineTextMetrics function can be used to retrieve metric information for TrueType fonts, including the style name.

GetOutlineTextMetrics is prototyped as follows:

   DWORD GetOutlineTextMetrics(HDC hdc, UINT cbData,
                               LPOUTLINETEXTMETRIC lpotm);

The cbData parameter specifies the size, in bytes, of the buffer in which information is returned.

The lpotm parameter points to an OUTLINETEXTMETRIC structure. If this parameter is NULL, the function returns the size of the buffer required for the retrieved metric information.

The OUTLINETEXTMETRIC structure contains most of the font metric information provided with the TrueType format. The relative parts of the structure are listed below:

     typedef struct tagOUTLINETEXTMETRIC {
       .
       .
       .
         PSTR    otmpFamilyName;
         PSTR    otmpFaceName;
         PSTR    otmpStyleName;
         PSTR    otmpFullName;
     } OUTLINETEXTMETRIC;

  #include <windows.h>
  #include <windowsx.h>
  .
  .
  .
  HFONT                hFont;
  LPOUTLINETEXTMETRIC  potm;
  TEXTMETRIC           tm;
  int                  cbBuffer;

  hFont = CreateFont( ..... );

  hFont = SelectObject(hDC, hFont);

  /*
   * Call the GetTextMetrics function to determine whether or not the
   * font is a TrueType font.
   */
  GetTextMetrics(hDC, &tm);

  /*
  * GetOutlineTextMetrics is a function implemented in Windows 3.1
  * and later. Assume fWin30 was determined by calling GetVersion.
  */
  if (!fWin30 && tm.tmPitchAndFamily & TMPF_TRUETYPE)
  {
     WORD (WINAPI *lpfnGOTM)(HDC, UINT, LPOUTLINETEXTMETRIC);

     /*
      * GetOutlineTextMetrics is exported from
      * GDI.EXE at ordinal #308
      */
     lpfnGOTM = GetProcAddress(GetModuleHandle("GDI"),
                               MAKEINTRESOURCE(308));

     /*
      * Call GOTM with NULL to retrieve the size of the buffer.
      */
     cbBuffer = (*lpfnGOTM)(hDC, NULL, NULL);

     if (cbBuffer == 0)
     {
       /* GetOutlineTextMetrics failed! */
       hFont = SelectObject(hDC, hFont);
       DeleteObject(hFont);
       return FALSE;
     }

     /*
      * Allocate the memory for the OUTLINETEXTMETRIC structure plus
      * the strings.
      */
     potm = (LPOUTLINETEXTMETRIC)GlobalAllocPtr(GHND, cbBuffer);

     if (potm)
     {
       potm->otmSize = cbBuffer;

       /*
        * Call GOTM with the pointer to the buffer. It will
        * fill in the buffer.
        */
       if (!(*lpfnGOTM)(hDC, cbBuffer, potm))
       {
          /* GetOutlineTextMetrics failed! */
          hFont = SelectObject(hDC, hFont);
          DeleteObject(hFont);
          return FALSE;
       }

       /*
        * Do something useful with the string buffers. NOTE: To access
        * the string buffers, the otmp???Name members are used as
        * OFFSETS into the buffer. They *ARE NOT* pointers themselves.
        */
       OutputDebugString((LPSTR)potm + (UINT)potm->otmpFamilyName);
       OutputDebugString((LPSTR)potm + (UINT)potm->otmpFaceName);
       OutputDebugString((LPSTR)potm + (UINT)potm->otmpStyleName);
       OutputDebugString((LPSTR)potm + (UINT)potm->otmpFullName);

       /* Don't forget to free the memory! */
       GlobalFreePtr(potm);
     }
     else
     {
       /* GlobalAllocPtr failed */
       hFont = SelectObject(hDC, hFont);
       DeleteObject(hFont);
       return FALSE;
     }
  }
  else
  {
     /*
      * It was not a TrueType font, or Windows 3.0 is running.
      */
     LOGFONT lf;
     char    szStyle[LF_FACESIZE];
     LPSTR   p;

     GetObject(hFont, sizeof(LOGFONT), &lf);

     /*
      * Fabricate a style string. Important note! The strings
      * "Italic", "Bold", and "Regular" are only valid in English. On
      * versions of Windows localized for other countries, these
      * strings will differ.
      */
     szStyle[0] = '\0';

     if (lf.lfWeight >= FW_BOLD)
       lstrcpy(szStyle, "Bold ");

     /*
      * If it's "Bold Italic," concatenate.
      */
      p = szStyle + lstrlen(szStyle);

      if (lf.lfItalic)
        lstrcpy(p, "Italic");

      if (!lstrlen(szStyle))
        lstrcpy(szStyle, "Regular");

     /*
      * szStyle now holds what is equivalent to the otmpStyleName
      * member.
      */
     OutputDebugString(szStyle);
  }

  hFont = SelectObject(hDC, hFont);
  DeleteObject(hFont);