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 = gcnew 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( String::Format( "descentFontFamily.GetCellDescent() returns {0}.", cellDescent ),
            gcnew System::Drawing::Font( descentFontFamily,16 ), Brushes::Black, PointF(0,0) );
   }

.NET Framework
Available since 1.1
Return to top
Show: