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()

Исходный код:

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)

Исходный код:

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 Forms и требует 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 имеет значение свойства UnitGraphicsUnit.Pixel и значение свойства DpiY 96 точек на дюйм, высота вычисляется следующим образом:

2355*(0.3/2048)*96 = 33.1171875

Продолжая этот же пример, предположим, что свойство Unit объекта Graphics имеет значение GraphicsUnit.Millimeter, а не GraphicsUnit.Pixel. Затем (с использованием 1 дюйма = 25,4 миллиметра) высота, в миллиметрах, вычисляется следующим образом:

2355*(0.3/2048)25.4 = 8.762256

См. также раздел

• практическое руководство. Получение метрик шрифта

GetHeight(Single)

Исходный код:

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

См. также раздел

• практическое руководство. Получение метрик шрифта