Font.GetHeight Method

Definition

Retorna o espaçamento entre linhas dessa fonte.Returns the line spacing of this font.

Overloads

GetHeight()

Retorna o espaçamento entre linhas, em pixels, dessa fonte.Returns the line spacing, in pixels, of this font.

GetHeight(Graphics)

Retorna o espaçamento entre linhas, na unidade atual de um Graphics especificado, dessa fonte.Returns the line spacing, in the current unit of a specified Graphics, of this font.

GetHeight(Single)

Retorna a altura, em pixels, deste Font quando desenhado em um dispositivo com a resolução vertical especificada.Returns the height, in pixels, of this Font when drawn to a device with the specified vertical resolution.

GetHeight()

Retorna o espaçamento entre linhas, em pixels, dessa fonte.Returns the line spacing, in pixels, of this font.

public:
 float GetHeight();
public float GetHeight ();
member this.GetHeight : unit -> single
Public Function GetHeight () As Single

Returns

Single

O espaçamento entre linhas, em pixels, dessa fonte.The line spacing, in pixels, of this font.

Remarks

O espaçamento de linha de uma Font é a distância vertical entre as linhas base de duas linhas consecutivas de texto.The line spacing of a Font is the vertical distance between the base lines of two consecutive lines of text. Portanto, o espaçamento de linha inclui o espaço em branco entre as linhas junto com a altura do próprio caractere.Thus, the line spacing includes the blank space between lines along with the height of the character itself.

Se a propriedade Unit da fonte for definida como algo diferente de GraphicsUnit.Pixel, a altura (em pixels) será calculada usando a resolução vertical da tela.If the Unit property of the font is set to anything other than GraphicsUnit.Pixel, the height (in pixels) is calculated using the vertical resolution of the screen display. Por exemplo, suponha que a unidade de fonte é polegadas e o tamanho da fonte é 0,3.For example, suppose the font unit is inches and the font size is 0.3. Além disso, suponha que, para a família de fontes correspondente, a altura seja 2048 e o espaçamento de linha seja 2355.Also suppose that for the corresponding font family, the em-height is 2048 and the line spacing is 2355. Para uma exibição de tela que tenha uma resolução vertical de 96 pontos por polegada, você pode calcular a altura da seguinte maneira:For a screen display that has a vertical resolution of 96 dots per inch, you can calculate the height as follows:

2355 * (0,3/2048)*96 = 33,117192355*(0.3/2048)*96 = 33.11719

GetHeight(Graphics)

Retorna o espaçamento entre linhas, na unidade atual de um Graphics especificado, dessa fonte.Returns the line spacing, in the current unit of a specified Graphics, of this font.

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

Parameters

graphics
Graphics

Um Graphics que contém a resolução vertical, em pontos por polegada, do dispositivo de vídeo, bem como as configurações de unidade de página e a escala de página.A Graphics that holds the vertical resolution, in dots per inch, of the display device as well as settings for page unit and page scale.

Returns

Single

O espaçamento entre linhas, em pixels, dessa fonte.The line spacing, in pixels, of this font.

Exceptions

graphics é null.graphics is null.

Examples

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos de Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. O código executa as seguintes ações:The code performs the following actions:

  • Cria um Font.Creates a Font.

  • Desenha uma linha de texto na tela, usando o novo Font.Draws a line of text to the screen, using the new Font.

  • Obtém a altura da fonte.Gets the height of the font.

  • Desenha uma segunda linha de texto diretamente abaixo da primeira linha.Draws a second line of text directly below the first line.

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

Remarks

O espaçamento de linha de uma Font é a distância vertical entre as linhas base de duas linhas consecutivas de texto.The line spacing of a Font is the vertical distance between the base lines of two consecutive lines of text. Portanto, o espaçamento de linha inclui o espaço em branco entre as linhas junto com a altura do próprio caractere.Thus, the line spacing includes the blank space between lines along with the height of the character itself.

Se a propriedade Unit da fonte for definida como algo diferente de GraphicsUnit.Pixel, a altura, em pixels, será calculada usando a resolução vertical do objeto de Graphics especificado.If the Unit property of the font is set to anything other than GraphicsUnit.Pixel, the height, in pixels, is calculated using the vertical resolution of the specified Graphics object. Por exemplo, suponha que a unidade de fonte é polegadas e o tamanho da fonte é 0,3.For example, suppose the font unit is inches and the font size is 0.3. Além disso, suponha que, para a família de fontes correspondente, a altura seja 2048 e o espaçamento de linha seja 2355.Also suppose that for the corresponding font family, the em-height is 2048 and the line spacing is 2355. Se o objeto Graphics tiver um valor de propriedade Unit de GraphicsUnit.Pixel e um valor de propriedade DpiY de 96 pontos por polegada, a altura será calculada da seguinte maneira:If the Graphics object has a Unit property value of GraphicsUnit.Pixel and a DpiY property value of 96 dots per inch, the height is calculated as follows:

2355 * (0,3/2048)*96 = 33,11718752355*(0.3/2048)*96 = 33.1171875

Continuando com o mesmo exemplo, suponha que a propriedade Unit do objeto Graphics esteja definida como GraphicsUnit.Millimeter em vez de GraphicsUnit.Pixel.Continuing with the same example, suppose the Unit property of the Graphics object is set to GraphicsUnit.Millimeter rather than GraphicsUnit.Pixel. Em seguida, (usando 1 polegada = 25,4 milímetros) a altura, em milímetros, é calculada da seguinte maneira:Then (using 1 inch = 25.4 millimeters) the height, in millimeters, is calculated as follows:

2355*(0.3/2048)25.4 = 8.7622562355*(0.3/2048)25.4 = 8.762256

See also

GetHeight(Single)

Retorna a altura, em pixels, deste Font quando desenhado em um dispositivo com a resolução vertical especificada.Returns the height, in pixels, of this Font when drawn to a device with the specified vertical resolution.

public:
 float GetHeight(float dpi);
public float GetHeight (float dpi);
member this.GetHeight : single -> single
Public Function GetHeight (dpi As Single) As Single

Parameters

dpi
Single

A resolução vertical, em pontos por polegada, usada para calcular a altura da fonte.The vertical resolution, in dots per inch, used to calculate the height of the font.

Returns

Single

A altura, em pixels, deste Font.The height, in pixels, of this Font.

Remarks

Se a propriedade Unit da fonte for definida como algo diferente de GraphicsUnit.Pixel, a altura (em pixels) será calculada usando a resolução vertical da tela.If the Unit property of the font is set to anything other than GraphicsUnit.Pixel, the height (in pixels) is calculated using the vertical resolution of the screen display. Por exemplo, suponha que a unidade de fonte é polegadas e o tamanho da fonte é 0,3.For example, suppose the font unit is inches and the font size is 0.3. Além disso, suponha que, para a família de fontes correspondente, a altura seja 2048 e o espaçamento de linha seja 2355.Also suppose that for the corresponding font family, the em-height is 2048 and the line spacing is 2355. Se a resolução vertical especificada for de 96 pontos por polegada, a altura será calculada da seguinte maneira:If the specified vertical resolution is 96 dots per inch, the height is calculated as follows:

2355 * (0,3/2048)*96 = 33,11718752355*(0.3/2048)*96 = 33.1171875

See also

Applies to