Obtendo métricas de fonte

  • Artigo

A classe FontFamily fornece os seguintes métodos que recuperam várias métricas para uma combinação de família/estilo específica:

Os números retornados por esses métodos estão em unidades de design de fonte, portanto, eles são independentes do tamanho e das unidades de um objeto Font específico.

A ilustração a seguir mostra a ascensão, a descida e o espaçamento de linhas.

diagrama de dois caracteres em linhas adjacentes, mostrando a ascensão da célula, a descida da célula e o espaçamento de linha

O exemplo a seguir exibe as métricas para o estilo normal da família de fontes Arial. O código também cria um objeto Font (baseado na família Arial) com tamanho de 16 pixels e exibe as métricas (em pixels) para esse objeto Font específico.

#define INFO_STRING_SIZE 100  // one line of output including null terminator
WCHAR infoString[INFO_STRING_SIZE] = L"";
UINT  ascent;                 // font family ascent in design units
REAL  ascentPixel;            // ascent converted to pixels
UINT  descent;                // font family descent in design units
REAL  descentPixel;           // descent converted to pixels
UINT  lineSpacing;            // font family line spacing in design units
REAL  lineSpacingPixel;       // line spacing converted to pixels
                       
FontFamily   fontFamily(L"Arial");
Font         font(&fontFamily, 16, FontStyleRegular, UnitPixel);
PointF       pointF(10.0f, 10.0f);
SolidBrush   solidBrush(Color(255, 0, 0, 0));

// Display the font size in pixels.
StringCchPrintf(
   infoString, 
   INFO_STRING_SIZE, 
   L"font.GetSize() returns %f.", font.GetSize());

graphics.DrawString(
   infoString, -1, &font, pointF, &solidBrush);

// Move down one line.
pointF.Y += font.GetHeight(0.0);

// Display the font family em height in design units.
StringCchPrintf(
   infoString, 
   INFO_STRING_SIZE, 
   L"fontFamily.GetEmHeight() returns %d.", 
   fontFamily.GetEmHeight(FontStyleRegular));

graphics.DrawString(infoString, -1, &font, pointF, &solidBrush);

// Move down two lines.
pointF.Y += 2.0f * font.GetHeight(0.0f);

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

// 14.484375 = 16.0 * 1854 / 2048
ascentPixel = 
   font.GetSize() * ascent / fontFamily.GetEmHeight(FontStyleRegular);

StringCchPrintf(
   infoString,
   INFO_STRING_SIZE,
   L"The ascent is %d design units, %f pixels.",
   ascent, 
   ascentPixel);

graphics.DrawString(infoString, -1, &font, pointF, &solidBrush);

// Move down one line.
pointF.Y += font.GetHeight(0.0f);

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

// 3.390625 = 16.0 * 434 / 2048
descentPixel = 
   font.GetSize() * descent / fontFamily.GetEmHeight(FontStyleRegular);

StringCchPrintf(
   infoString, 
   INFO_STRING_SIZE,
   L"The descent is %d design units, %f pixels.",
   descent, 
   descentPixel);

graphics.DrawString(infoString, -1, &font, pointF, &solidBrush);

// Move down one line.
pointF.Y += font.GetHeight(0.0f);

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

// 18.398438 = 16.0 * 2355 / 2048
lineSpacingPixel = 
   font.GetSize() * lineSpacing / fontFamily.GetEmHeight(FontStyleRegular);

StringCchPrintf(
   infoString, 
   INFO_STRING_SIZE,
   L"The line spacing is %d design units, %f pixels.",
   lineSpacing, 
   lineSpacingPixel);

graphics.DrawString(infoString, -1, &font, pointF, &solidBrush);

A ilustração a seguir mostra a saída do código anterior.

captura de tela de uma janela com texto que indica o tamanho e a altura da fonte e o espaçamento de ascento, descendente e linha

Observe as duas primeiras linhas de saída na ilustração anterior. O objeto Font retorna um tamanho de 16 e o objeto FontFamily retorna uma altura em de 2.048. Esses dois números (16 e 2.048) são a chave para converter entre unidades de design de fonte e as unidades (nesse caso, pixels) do objeto Font .

Por exemplo, você pode converter o ascendente de unidades de design em pixels da seguinte maneira:

equação que multiplica 1854 unidades de design por 16 pixels divididos por 2048 unidades de design, igualando 14,484375 pixels

O código anterior posiciona o texto verticalmente definindo o membro de dados y de um objeto PointF . A coordenada y é aumentada em font.GetHeight(0.0f) para cada nova linha de texto. O método Font::GetHeight de um objeto Font retorna o espaçamento de linha (em pixels) para esse objeto Font específico. Neste exemplo, o número retornado por Font::GetHeight é 18.398438. Observe que isso é o mesmo que o número obtido convertendo a métrica de espaçamento de linha em pixels.