FONTMETRIC( ) Function

Returns font attributes for the current installed operating system fonts.

FONTMETRIC(nAttribute [, cFontName, nFontSize [, cFontStyle]])

Parameters

• nAttribute
  Determines the font attribute FONTMETRIC( ) returns. If you omit cFontName, nFontSize, and cFontStyle, FONTMETRIC( ) returns the attribute for the current font in the active output window.

  The following table lists values for nAttribute and the corresponding font attributes returned.

  NAttribute	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 (0 = no, nonzero = yes)
  10	Underlined (0 = no, nonzero = yes)
  11	Strikeout (0 = 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

  For more information about the numeric values returned by FONTMETRIC( ), see the TEXTMETRIC function in the Microsoft Windows Programmer's Reference.

• cFontName
  Specifies the name of an installed font.

• nFontSize
  Specifies the point size of the font specified with cFontName.

• cFontStyle
  Specifies a font style code for the font specified with cFontName. If you omit cFontStyle, FONTMETRIC( ) returns the attribute for the Normal font style.

  cFontStyle can be a character or a combination of characters listed in the following font style table. For example, the combination BI specifies the Bold Italic font style.

  Character	Font style
  B	Bold
  I	Italic
  N	Normal
  O	Outline
  Q	Opaque
  S	Shadow
  –	Strikeout
  T	Transparent
  U	Underline

Return Value

Numeric

Remarks

FONTMETRIC( ) returns font attributes for the current font for the active output window. WFONT( ) can be used to determine the current window font.

See Also

Concepts

Fonts Overview

Reference

AFONT( ) Function

GETFONT( ) Function

SYSMETRIC( ) Function

TXTWIDTH( ) Function

Other Resources

Functions

Language Reference (Visual FoxPro)