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

Класс FontFamily предоставляет следующие методы, которые извлекают различные метрики для определенного сочетания семейства и стиля:

• GetEmHeight(FontStyle)

• GetCellAscent(FontStyle)

• GetCellDescent(FontStyle)

• GetLineSpacing(FontStyle)

Значения, возвращаемые этими методами, находятся в единицах конструктора шрифтов, поэтому они не зависят от размера и единиц конкретного объекта Font.

На рисунке ниже показаны различные метрики:

Пример

В следующем примере показаны метрики для обычного стиля семейства шрифтов Arial. Код также создает объект Font (на основе семейства Arial) размером 16 пикселей и отображает метрики (в пикселях) для этого конкретного объекта Font.

На следующем рисунке показан результат выполнения этого примера кода:

Обратите внимание на первые две строки выходных данных на рисунке выше. Объект Font возвращает размер 16, а объект FontFamily возвращает высоту кегельной шпации 2048. Эти два числа (16 и 2048) являются ключом для преобразования между единицами конструктора шрифтов и единицами (в данном случае пикселями) объекта Font.

Например, вы можете преобразовать переход из единиц конструктора в пиксели следующим образом:

Следующий код позиционирует текст по вертикали, задав элемент данных Y объекта PointF. Координата Y увеличивается на font.Height за каждую новую строку текста. Свойство Height объекта Font возвращает интервал строки (в пикселях) для этого конкретного объекта Font. В этом примере число, возвращаемое свойством Height, равно 19. Обратите внимание, что значение совпадает с числом (округленным до целого числа), полученным путем преобразования метрики междустрочного интервала в пиксели.

Обратите внимание, что высота кегельной шпации (также называемая размером или размером кегельной шпации) не является суммой восхождения и спуска по высоте. Сумма восхождения и спуска называется высотой ячейки. Вычитая из высоты ячейки внутренний сдвиг мы получаем высоту кегельной шпации. Прибавляя к высоте ячейки внешний сдвиг мы получаем междустрочный интервал.

string infoString = "";  // enough space for one line of output
int ascent;             // font family ascent in design units
float ascentPixel;      // ascent converted to pixels
int descent;            // font family descent in design units
float descentPixel;     // descent converted to pixels
int lineSpacing;        // font family line spacing in design units
float lineSpacingPixel; // line spacing converted to pixels

FontFamily fontFamily = new FontFamily("Arial");
Font font = new Font(
   fontFamily,
   16, FontStyle.Regular,
   GraphicsUnit.Pixel);
PointF pointF = new PointF(10, 10);
SolidBrush solidBrush = new SolidBrush(Color.Black);

// Display the font size in pixels.
infoString = "font.Size returns " + font.Size + ".";
e.Graphics.DrawString(infoString, font, solidBrush, pointF);

// Move down one line.
pointF.Y += font.Height;

// Display the font family em height in design units.
infoString = "fontFamily.GetEmHeight() returns " +
   fontFamily.GetEmHeight(FontStyle.Regular) + ".";
e.Graphics.DrawString(infoString, font, solidBrush, pointF);

// Move down two lines.
pointF.Y += 2 * font.Height;

// Display the ascent in design units and pixels.
ascent = fontFamily.GetCellAscent(FontStyle.Regular);

// 14.484375 = 16.0 * 1854 / 2048
ascentPixel =
   font.Size * ascent / fontFamily.GetEmHeight(FontStyle.Regular);
infoString = "The ascent is " + ascent + " design units, " + ascentPixel +
   " pixels.";
e.Graphics.DrawString(infoString, font, solidBrush, pointF);

// Move down one line.
pointF.Y += font.Height;

// Display the descent in design units and pixels.
descent = fontFamily.GetCellDescent(FontStyle.Regular);

// 3.390625 = 16.0 * 434 / 2048
descentPixel =
   font.Size * descent / fontFamily.GetEmHeight(FontStyle.Regular);
infoString = "The descent is " + descent + " design units, " +
   descentPixel + " pixels.";
e.Graphics.DrawString(infoString, font, solidBrush, pointF);

// Move down one line.
pointF.Y += font.Height;

// Display the line spacing in design units and pixels.
lineSpacing = fontFamily.GetLineSpacing(FontStyle.Regular);

// 18.398438 = 16.0 * 2355 / 2048
lineSpacingPixel =
font.Size * lineSpacing / fontFamily.GetEmHeight(FontStyle.Regular);
infoString = "The line spacing is " + lineSpacing + " design units, " +
   lineSpacingPixel + " pixels.";
e.Graphics.DrawString(infoString, font, solidBrush, pointF);

Dim infoString As String = "" ' enough space for one line of output
Dim ascent As Integer ' font family ascent in design units
Dim ascentPixel As Single ' ascent converted to pixels
Dim descent As Integer ' font family descent in design units
Dim descentPixel As Single ' descent converted to pixels
Dim lineSpacing As Integer ' font family line spacing in design units
Dim lineSpacingPixel As Single ' line spacing converted to pixels
Dim fontFamily As New FontFamily("Arial")
Dim font As New Font( _
   fontFamily, _
   16, _
   FontStyle.Regular, _
   GraphicsUnit.Pixel)
Dim pointF As New PointF(10, 10)
Dim solidBrush As New SolidBrush(Color.Black)

' Display the font size in pixels.
infoString = "font.Size returns " & font.Size.ToString() & "."
e.Graphics.DrawString(infoString, font, solidBrush, pointF)

' Move down one line.
pointF.Y += font.Height

' Display the font family em height in design units.
infoString = "fontFamily.GetEmHeight() returns " & _
   fontFamily.GetEmHeight(FontStyle.Regular) & "."
e.Graphics.DrawString(infoString, font, solidBrush, pointF)

' Move down two lines.
pointF.Y += 2 * font.Height

' Display the ascent in design units and pixels.
ascent = fontFamily.GetCellAscent(FontStyle.Regular)

' 14.484375 = 16.0 * 1854 / 2048
ascentPixel = _
   font.Size * ascent / fontFamily.GetEmHeight(FontStyle.Regular)
infoString = "The ascent is " & ascent & " design units, " & ascentPixel _
   & " pixels."
e.Graphics.DrawString(infoString, font, solidBrush, pointF)

' Move down one line.
pointF.Y += font.Height

' Display the descent in design units and pixels.
descent = fontFamily.GetCellDescent(FontStyle.Regular)

' 3.390625 = 16.0 * 434 / 2048
descentPixel = _
   font.Size * descent / fontFamily.GetEmHeight(FontStyle.Regular)
infoString = "The descent is " & descent & " design units, " & _
   descentPixel & " pixels."
e.Graphics.DrawString(infoString, font, solidBrush, pointF)

' Move down one line.
pointF.Y += font.Height

' Display the line spacing in design units and pixels.
lineSpacing = fontFamily.GetLineSpacing(FontStyle.Regular)

' 18.398438 = 16.0 * 2355 / 2048
lineSpacingPixel = _
   font.Size * lineSpacing / fontFamily.GetEmHeight(FontStyle.Regular)
infoString = "The line spacing is " & lineSpacing & " design units, " & _
   lineSpacingPixel & " pixels."
e.Graphics.DrawString(infoString, font, solidBrush, pointF)

Компиляция кода

Приведенный выше пример предназначен для использования с Windows Forms и требуется PaintEventArgs e, который является параметром PaintEventHandler.

См. также

• Объекты Graphics и Drawing в Windows Forms
• Работами со шрифтами и текстом