Font::GetHeight(constGraphics*)-Methode (gdiplusheaders.h)

Die Font::GetHeight-Methode ruft den Zeilenabstand dieser Schriftart in der aktuellen Einheit eines angegebenen Graphics-Objekts ab. Der Zeilenabstand entspricht dem vertikalen Abstand zwischen den Basislinien zweier aufeinander folgender Textzeilen. Daher umfasst der Zeilenabstand den Leerraum zwischen den Zeilen zusammen mit der Höhe des Zeichens selbst.

Syntax

REAL GetHeight(
  const Graphics *graphics
);

Parameter

graphics

Zeiger auf ein Graphics-Objekt , dessen Einheit und vertikale Auflösung bei der Höhenberechnung verwendet werden.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Wenn die Schrifteinheit auf einen anderen Wert als UnitPixel festgelegt ist, wird die Höhe in Pixel mithilfe der vertikalen Auflösung des angegebenen Graphics-Objekts berechnet. Angenommen, die Schrifteinheit ist Zoll und der Schriftgrad 0,3. Angenommen, für die entsprechende Schriftfamilie beträgt die Em-Höhe 2048 und der Zeilenabstand 2355. Wenn die Einheit des Graphics-Objekts UnitPixel ist und die vertikale Auflösung des Graphics-Objekts 96 Punkte pro Zoll beträgt, wird die Höhe wie folgt berechnet:

2355*(0.3/2048)*96 = 33.1171875

Wenn Sie mit demselben Beispiel fortfahren, nehmen Sie an, dass die Einheit des Graphics-Objekts etwas anderes als UnitPixel ist, z. B. UnitMillimeter. Dann (unter Verwendung von 1 Zoll = 25,4 Millimeter) wird die Höhe in Millimetern wie folgt berechnet:

2355*(0.3/2048)25.4 = 8.762256

Beispiele

Im folgenden Beispiel wird ein Font-Objekt erstellt, die Höhe des Font-Objekts abgerufen und die Höhe verwendet, um zwei Textzeilen zu positionieren, wobei die zweite Zeile direkt unter der ersten Zeile liegt.

VOID Example_GetHeight(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Font object.
   Font myFont(L"Arial", 16);

   // Draw text with myFont.
   SolidBrush solidbrush_1(Color(255, 0, 0, 0));
   WCHAR string[] = L"The first line of text";
   graphics.DrawString(string, 22, &myFont, PointF(0, 0), &solidbrush_1);

   // Get the height of myFont.
   REAL height = myFont.GetHeight(&graphics);

   // Draw text immediately below the first line of text.
   SolidBrush solidbrush_2(Color(255, 255, 0, 0));
   WCHAR string[] = L"The second line of text";
   graphics.DrawString(string2, 23, &myFont, PointF(0, height),
                       &solidbrush_2);
}

Requirements (Anforderungen)

Kopfzeile	gdiplusheaders.h

Weitere Informationen

Schriftart

Grafiken

Verwenden von Text und Schriftarten