Font.GetHeight Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v9.0.0-rc.2.24474.1

Retorna o espaçamento de linha dessa fonte.

Sobrecargas

GetHeight()	Retorna o espaçamento de linha, em pixels, dessa fonte.
GetHeight(Graphics)	Retorna o espaçamento de linha, na unidade atual de um Graphicsespecificado, dessa fonte.
GetHeight(Single)	Retorna a altura, em pixels, dessa Font quando desenhada para um dispositivo com a resolução vertical especificada.

GetHeight()

Origem:

Font.cs

Retorna o espaçamento de linha, em pixels, dessa fonte.

public:
 float GetHeight();

public float GetHeight ();

member this.GetHeight : unit -> single

Public Function GetHeight () As Single

Retornos

Single

O espaçamento de linha, em pixels, dessa fonte.

Comentários

O espaçamento de linha de um Font é a distância vertical entre as linhas base de duas linhas consecutivas de texto. Assim, o espaçamento de linha inclui o espaço em branco entre linhas, juntamente com a altura do próprio caractere.

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. Por exemplo, suponha que a unidade de fonte seja polegadas e o tamanho da fonte seja 0,3. Suponha também que, para a família de fontes correspondente, a altura em é 2048 e o espaçamento de linha é 2355. Para uma exibição de tela que tem uma resolução vertical de 96 pontos por polegada, você pode calcular a altura da seguinte maneira:

2355*(0,3/2048)*96 = 33,11719

GetHeight(Graphics)

Origem:

Font.cs

Retorna o espaçamento de linha, na unidade atual de um Graphicsespecificado, dessa fonte.

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

Parâmetros

graphics

Graphics

Um Graphics que contém a resolução vertical, em pontos por polegada, do dispositivo de exibição, bem como as configurações para a unidade de página e a escala de página.

Retornos

Single

O espaçamento de linha, em pixels, dessa fonte.

Exceções

ArgumentNullException

graphics é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

• Cria um Font.

• Desenha uma linha de texto para a tela, usando o novo Font.

• Obtém a altura da fonte.

• Desenha uma segunda linha de texto diretamente abaixo da primeira linha.

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

Comentários

O espaçamento de linha de um Font é a distância vertical entre as linhas base de duas linhas consecutivas de texto. Assim, o espaçamento de linha inclui o espaço em branco entre linhas, juntamente com a altura do próprio caractere.

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 Graphics especificado. Por exemplo, suponha que a unidade de fonte seja polegadas e o tamanho da fonte seja 0,3. Suponha também que, para a família de fontes correspondente, a altura em é 2048 e o espaçamento de linha é 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:

2355*(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. Em seguida (usando 1 polegada = 25,4 milímetros) a altura, em milímetros, é calculada da seguinte maneira:

2355*(0,3/2048)25,4 = 8,762256

Confira também

• Como obter métricas de fonte

GetHeight(Single)

Origem:

Font.cs

Retorna a altura, em pixels, dessa Font quando desenhada para um dispositivo com a resolução vertical especificada.

public:
 float GetHeight(float dpi);

public float GetHeight (float dpi);

member this.GetHeight : single -> single

Public Function GetHeight (dpi As Single) As Single

Parâmetros

dpi

Single

A resolução vertical, em pontos por polegada, usada para calcular a altura da fonte.

Retornos

Single

A altura, em pixels, deste Font.

Comentários

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. Por exemplo, suponha que a unidade de fonte seja polegadas e o tamanho da fonte seja 0,3. Suponha também que, para a família de fontes correspondente, a altura em é 2048 e o espaçamento de linha é 2355. Se a resolução vertical especificada for de 96 pontos por polegada, a altura será calculada da seguinte maneira:

2355*(0,3/2048)*96 = 33,1171875

Confira também

• Como obter métricas de fonte