KnowledgeBase Archive

An Archive of Early Microsoft KnowledgeBase Articles

View on GitHub

Q94350: FoxPro FONTMETRIC() Function Returns Font Attributes

Article: Q94350
Product(s): Microsoft FoxPro
Version(s): WINDOWS:2.5,2.5a,3.0,5.0,6.0
Operating System(s): 
Keyword(s): 
Last Modified: 03-FEB-2000

-------------------------------------------------------------------------------
The information in this article applies to:

- Microsoft Visual FoxPro for Windows, versions 3.0, 5.0, 6.0 
- Microsoft FoxPro for Windows, versions 2.5, 2.5a 
-------------------------------------------------------------------------------

SUMMARY
=======

The FONTMETRIC() function returns the attributes of a font installed in the
Microsoft Windows environment. Font attributes include the character height,
character ascent, leading space between lines, and font weight. The syntax of
the FONTMETRIC() function is as follows:

  FONTMETRIC(<expN1>[,<expC1>,<expN2>[,<expC2>]])

The <expN1> parameter specifies the desired font attribute. If the
<expC1> and <expN2> parameters are omitted, FONTMETRIC() returns the
specified attribute of the current font in the active output window. The
following table lists the <expN1> values and their corresponding font
attributes.

  <expN1> value   Attribute
  --------------------------------------------------------------------

   1              Character height in pixels
   2              Character ascent (units above baseline) in pixels
   3              Character descent (units below baseline) in pixels
   4              Leading (space between lines) in pixels
   5              Extra leading in pixels
   6              Average character width in pixels
   7              Maximum character width in pixels
   8              Font weight
   9              Italic (zero = no, nonzero = yes)
  10              Underlined (zero = no, nonzero = yes)
  11              Strikeout (zero = no, nonzero = yes)
  12              First character defined in font
  13              Last character defined in font
  14              Default character (substituted for
                     characters not in font)
  15              Word break character
  16              Pitch and family
  17              Character set
  18              Overhang (extra added width)
  19              Horizontal aspect for font device
  20              Vertical aspect for font device

The <expC1> parameter specifies a font name and returns the desired
attribute for a specific installed font.

The <expN2> parameter specifies the point size for a font specified in the
<expC1> parameter.

The <expC2> parameter specifies a font style code. When an application
specifies <expC2>, FoxPro returns the desired attribute for a font with
the specified font style. If <expC2> is omitted, FoxPro returns the
specified information regarding a font with normal style. The <expC2>
parameter can contain one or more characters from the following font style
table.

  Character       Font style
  ---------------------------

      -           Strikeout
      B           Bold
      I           Italic
      N           Normal
      O           Outline
      Q           Opaque
      S           Shadow
      T           Transparent
      U           Underline

Additional query words: VFoxWin FoxWin 2.50

======================================================================
Keywords          :  
Technology        : kbVFPsearch kbAudDeveloper kbFoxproSearch kbFoxPro250 kbFoxPro250a kbVFP300 kbVFP500 kbVFP600
Version           : WINDOWS:2.5,2.5a,3.0,5.0,6.0

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 1986-2002.