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

Reference

AFONT( ) Function
GETFONT( ) Function
SYSMETRIC( ) Function
TXTWIDTH( ) Function

Concepts

Fonts Overview

Other Resources

Functions
Language Reference (Visual FoxPro)