FontFamily.GetCellDescent Method (FontStyle)

 

Returns the cell descent, in design units, of the FontFamily of the specified style.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public int GetCellDescent(
	FontStyle style
)

Parameters

style
Type: System.Drawing.FontStyle

A FontStyle that contains style information for the font.

Return Value

Type: System.Int32

The cell descent metric for this FontFamily that uses the specified FontStyle.

The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. The code performs the following actions:

  • Creates a FontFamily.

  • Gets the cell descent for that font family.

  • Draws the value of the cell descent to the screen as text.

public void GetCellDescent_Example(PaintEventArgs e)
{
    // Create a FontFamily object.
    FontFamily descentFontFamily = new FontFamily("arial");

    // Get the cell descent of the font family in design units.
    int cellDescent = descentFontFamily.GetCellDescent(FontStyle.Regular);

    // Draw the result as a string to the screen.
    e.Graphics.DrawString(
        "descentFontFamily.GetCellDescent() returns " + cellDescent.ToString() + ".",
        new Font(descentFontFamily, 16),
        Brushes.Black,
        new PointF(0, 0));
}

.NET Framework
Available since 1.1
Return to top
Show: