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 null beendet werden, da cbString- die Länge der Zeichenfolge angibt.
[in] c
Die Länge der Zeichenfolge, auf die durch 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 fehlschlägt, ist der Rückgabewert null.
Bemerkungen
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 berechnet, ohne Ausschnitte in Betracht zu ziehen. Außerdem geht diese Funktion davon aus, dass der Text horizontal ist, d. h. das Escapezeichen immer 0 ist. Dies gilt sowohl für die horizontale als auch für die vertikale Größe des Texts. Auch wenn eine Schriftart verwendet wird, die ein Escapezeichen ungleich Null angibt, verwendet diese Funktion beim Berechnen des Textumfangs nicht den Winkel. 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 intercharacter Abstand, der von der SetTextCharacterExtra-Funktion festgelegt wird.
Anmerkung
Der wingdi.h-Header definiert GetTextExtentPoint als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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