GetTextMetricsA-Funktion (wingdi.h)
Die GetTextMetrics--Funktion füllt den angegebenen Puffer mit den Metriken für die aktuell ausgewählte Schriftart aus.
Syntax
BOOL GetTextMetricsA(
[in] HDC hdc,
[out] LPTEXTMETRICA 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 fehlschlägt, ist der Rückgabewert null.
Bemerkungen
Um zu bestimmen, ob eine Schriftart eine TrueType-Schriftart ist, wählen Sie sie zuerst in einem DC aus, rufen Sie dann GetTextMetricsauf, und überprüfen 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 muss eine Schriftart in dc ausgewählt werden.
Beispiele
Ein Beispiel finden Sie unter "Anzeigen der Tastatureingabe" in Verwenden von Tastatureingaben oder Zeichnen von Text aus verschiedenen Schriftarten in derselben Zeile.
Anmerkung
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 Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | wingdi.h (enthalten Windows.h) |
| Library | Gdi32.lib |
| DLL- | Gdi32.dll |
Siehe auch
Schriftart- und Textfunktionen