GetTextMetrics-Funktion (wingdi.h)

Artikel
03/04/2024

Die GetTextMetrics-Funktion füllt den angegebenen Puffer mit den Metriken für die aktuell ausgewählte Schriftart aus.

Syntax

BOOL GetTextMetrics(
  [in]  HDC          hdc,
  [out] LPTEXTMETRIC lptm
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[out] lptm

Ein Zeiger auf die TEXTMETRIC-Struktur , die die Textmetriken empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Um zu bestimmen, ob es sich bei einer Schriftart um eine TrueType-Schriftart handelt, wählen Sie sie zuerst in einen DC aus, rufen Sie dann GetTextMetrics auf, und suchen Sie dann in TEXTMETRIC.tmPitchAndFamily nach TMPF_TRUETYPE. Beachten Sie, dass GetDC einen nicht initialisierten DC zurückgibt, der als Standardschriftart "System" (eine Bitmapschriftart) aufweist. daher die Notwendigkeit, eine Schriftart in den DC auszuwählen.

Beispiele

Ein Beispiel finden Sie unter "Anzeigen der Tastatureingabe" unter Verwenden der Tastatureingabe oder Zeichnen von Text aus unterschiedlichen Schriftarten in derselben Zeile.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll