GetTextMetricsW-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 GetTextMetricsW(
  [in]  HDC           hdc,
  [out] LPTEXTMETRICW 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 zunächst in einen DC aus, rufen Sie dann GetTextMetrics auf, und suchen Sie dann nach TMPF_TRUETYPE in TEXTMETRIC.tmPitchAndFamily. Beachten Sie, dass GetDC einen nicht initialisierten DC zurückgibt, der als Standardschriftart "System" (eine Bitmapschriftart) aufweist. daher die Notwendigkeit, eine Schriftart im DC auszuwählen.

Beispiele

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

Hinweis

Der wingdi.h-Header definiert GetTextMetrics als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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 (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll