GetTextExtentPointA-Funktion (wingdi.h)

Artikel
08/27/2023

Die GetTextExtentPoint-Funktion berechnet die Breite und Höhe der angegebenen Textzeichenfolge.

Hinweis Diese Funktion wird nur aus Gründen der Kompatibilität mit 16-Bit-Versionen von Windows bereitgestellt. Anwendungen sollten die GetTextExtentPoint32-Funktion aufrufen, die genauere Ergebnisse liefert.

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