GetTextExtentPointA-Funktion (wingdi.h)
Die GetTextExtentPoint-Funktion berechnet die Breite und Höhe der angegebenen Textzeichenfolge.
Syntax
BOOL GetTextExtentPointA(
[in] HDC hdc,
[in] LPCSTR lpString,
[in] int c,
[out] LPSIZE lpsz
);
Parameter
[in] hdc
Ein Handle für den Gerätekontext.
[in] lpString
Ein Zeiger auf die Zeichenfolge, die den Text angibt. Die Zeichenfolge muss nicht mit Null beendet werden, da cbString die Länge der Zeichenfolge angibt.
[in] c
Die Länge der Zeichenfolge , auf die lpString verweist.
[out] lpsz
Ein Zeiger auf eine SIZE-Struktur , die die Dimensionen der Zeichenfolge in logischen Einheiten 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
Die GetTextExtentPoint-Funktion verwendet die aktuell ausgewählte Schriftart, um die Dimensionen der Zeichenfolge zu berechnen. Die Breite und Höhe in logischen Einheiten werden ohne Berücksichtigung von Beschneidung berechnet. Außerdem geht diese Funktion davon aus, dass der Text horizontal ist, d. h., dass die Escapement immer 0 ist. Dies gilt sowohl für die horizontalen als auch für die vertikalen Maße des Texts. Selbst wenn eine Schriftart verwendet wird, die eine Escapementierung ungleich null angibt, verwendet diese Funktion nicht den Winkel beim Berechnen der Textausdehnung. Die Anwendung muss sie explizit konvertieren.
Da einige Geräte Kernzeichen enthalten, ist die Summe der Ausdehnungen der Zeichen in einer Zeichenfolge möglicherweise nicht gleich dem Umfang der Zeichenfolge.
Die berechnete Zeichenfolgenbreite berücksichtigt den Interzeichenabstand, der von der SetTextCharacterExtra-Funktion festgelegt wird.
Hinweis
Der wingdi.h-Header definiert GetTextExtentPoint 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
| 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 |
Weitere Informationen
Schriftart- und Textfunktionen