Font.GetHeight 方法

定义

命名空间:

System.Drawing

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v9.0.0-preview.6.24327.6

返回此字体的行距。

重载

GetHeight()	返回此字体的行距（以像素为单位）。
GetHeight(Graphics)	返回此字体的指定 Graphics的当前单位中的行距。
GetHeight(Single)	当绘制到具有指定垂直分辨率的设备时，返回此 Font 的高度（以像素为单位）。

GetHeight()

Source:

Font.cs

返回此字体的行距（以像素为单位）。

public:
 float GetHeight();

public float GetHeight ();

member this.GetHeight : unit -> single

Public Function GetHeight () As Single

返回

Single

此字体的行距（以像素为单位）。

注解

Font 的行距是两行连续文本的底线之间的垂直距离。 因此，行距包括行之间的空白空间以及字符本身的高度。

如果字体的 Unit 属性设置为除 GraphicsUnit.Pixel之外的任何属性，则使用屏幕显示器的垂直分辨率计算高度（以像素为单位）。 例如，假设字体单位为英寸，字号为 0.3。 另外，假设对于相应的字体系列，em 高度为 2048，行距为 2355。 对于垂直分辨率为 96 点/英寸的屏幕显示器，可以按如下所示计算高度：

2355*（0.3/2048）*96 = 33.11719

GetHeight(Graphics)

Source:

Font.cs

返回此字体的指定 Graphics的当前单位中的行距。

public:
 float GetHeight(System::Drawing::Graphics ^ graphics);

public float GetHeight (System.Drawing.Graphics graphics);

member this.GetHeight : System.Drawing.Graphics -> single

Public Function GetHeight (graphics As Graphics) As Single

参数

graphics

Graphics

一个 Graphics，用于保存显示设备的垂直分辨率（以每英寸点为单位），以及页面单位和页面缩放的设置。

返回

Single

此字体的行距（以像素为单位）。

例外

ArgumentNullException

graphics null。

示例

下面的代码示例设计用于 Windows 窗体，它需要 PaintEventArgse，这是 Paint 事件处理程序的参数。 该代码执行以下操作：

• 创建 Font。

• 使用新的 Font向屏幕绘制一行文本。

• 获取字体的高度。

• 在第一行下方绘制第二行文本。

public:
   void GetHeight_Example( PaintEventArgs^ e )
   {
      // Create a Font object.
      System::Drawing::Font^ myFont = gcnew System::Drawing::Font( "Arial",16 );

      //Draw text to the screen with myFont.
      e->Graphics->DrawString( "This is the first line", myFont, Brushes::Black, PointF(0,0) );

      //Get the height of myFont.
      float height = myFont->GetHeight( e->Graphics );

      //Draw text immediately below the first line of text.
      e->Graphics->DrawString( "This is the second line", myFont, Brushes::Black, PointF(0,height) );
   }

public void GetHeight_Example(PaintEventArgs e)
{
             
    // Create a Font object.
    Font myFont = new Font("Arial", 16);
             
    //Draw text to the screen with myFont.
    e.Graphics.DrawString("This is the first line",myFont,
        Brushes.Black, new PointF(0, 0));
             
    //Get the height of myFont.
    float height = myFont.GetHeight(e.Graphics);
             
    //Draw text immediately below the first line of text.
    e.Graphics.DrawString(
        "This is the second line",
        myFont,
        Brushes.Black,
        new PointF(0, height));
}

Public Sub GetHeight_Example(ByVal e As PaintEventArgs)

    ' Create a Font object.
    Dim myFont As New Font("Arial", 16)

    'Draw text to the screen with myFont.
    e.Graphics.DrawString("This is the first line", myFont, _
    Brushes.Black, New PointF(0, 0))

    'Get the height of myFont.
    Dim height As Single = myFont.GetHeight(e.Graphics)

    'Draw text immediately below the first line of text.
    e.Graphics.DrawString("This is the second line", myFont, _
    Brushes.Black, New PointF(0, height))
End Sub

注解

Font 的行距是两行连续文本的底线之间的垂直距离。 因此，行距包括行之间的空白空间以及字符本身的高度。

如果字体的 Unit 属性设置为除 GraphicsUnit.Pixel之外的任何属性，则使用指定 Graphics 对象的垂直分辨率计算高度（以像素为单位）。 例如，假设字体单位为英寸，字号为 0.3。 另外，假设对于相应的字体系列，em 高度为 2048，行距为 2355。 如果 Graphics 对象具有 Unit 属性值 GraphicsUnit.Pixel，并且 DpiY 属性值为每英寸 96 点，则高度计算如下：

2355*（0.3/2048）*96 = 33.1171875

继续同一示例，假设 Graphics 对象的 Unit 属性设置为 GraphicsUnit.Millimeter 而不是 GraphicsUnit.Pixel。 然后（使用 1 英寸 = 25.4 毫米）的高度（以毫米为单位）的计算方式如下：

2355*（0.3/2048）25.4 = 8.762256

另请参阅

• 如何：获取字体指标

GetHeight(Single)

Source:

Font.cs

当绘制到具有指定垂直分辨率的设备时，返回此 Font 的高度（以像素为单位）。

public:
 float GetHeight(float dpi);

public float GetHeight (float dpi);

member this.GetHeight : single -> single

Public Function GetHeight (dpi As Single) As Single

参数

dpi

Single

垂直分辨率（以每英寸点为单位）用于计算字体高度。

返回

Single

此 Font的高度（以像素为单位）。

注解

如果字体的 Unit 属性设置为除 GraphicsUnit.Pixel之外的任何属性，则使用屏幕显示器的垂直分辨率计算高度（以像素为单位）。 例如，假设字体单位为英寸，字号为 0.3。 另外，假设对于相应的字体系列，em 高度为 2048，行距为 2355。 如果指定的垂直分辨率为每英寸 96 点，则计算高度，如下所示：

2355*（0.3/2048）*96 = 33.1171875

另请参阅

• 如何：获取字体指标