GetTextExtentPointI-Funktion (wingdi.h)

Artikel
03/08/2023

Die GetTextExtentPointI-Funktion berechnet die Breite und Höhe des angegebenen Arrays von Glyphenindizes.

Syntax

BOOL GetTextExtentPointI(
  [in]  HDC    hdc,
  [in]  LPWORD pgiIn,
  [in]  int    cgi,
  [out] LPSIZE psize
);

Parameter

[in] hdc

Handle mit dem Gerätekontext.

[in] pgiIn

Zeiger auf ein Array von Glyphenindizes.

[in] cgi

Gibt die Anzahl der Glyphenindizes an.

[out] psize

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 GetTextExtentPointI-Funktion verwendet die aktuell ausgewählte Schriftart, um die Dimensionen des Arrays von Glyphenindizes zu berechnen. Die Breite und Höhe in logischen Einheiten werden ohne Berücksichtigung von Beschneidung berechnet.

Wenn diese Funktion den Textumfang zurückgibt, wird davon ausgegangen, dass der Text horizontal ist, d. h., dass die Escape immer 0 ist. Dies gilt sowohl für die horizontalen als auch für die vertikalen Messungen des Texts. Auch wenn Sie eine Schriftart verwenden, die eine nonzero-Escape angibt, verwendet diese Funktion nicht den Winkel, während sie die Textausdehnung berechnet. Die App muss sie explizit konvertieren. Wenn der Grafikmodus jedoch auf GM_ADVANCED festgelegt ist und die Zeichenausrichtung 90 Grad von der Druckausrichtung entfernt ist, entsprechen die von dieser Funktion zurückgegebenen Werte dieser Regel nicht. Wenn die Zeichenausrichtung und die Druckausrichtung für eine bestimmte Zeichenfolge übereinstimmen, gibt diese Funktion die Dimensionen der Zeichenfolge in der SIZE-Struktur als { cx : 116, cy : 18 }zurück. Wenn die Zeichenausrichtung und die Druckausrichtung für dieselbe Zeichenfolge 90 Grad voneinander entfernt sind, gibt diese Funktion die Dimensionen der Zeichenfolge in der SIZE-Struktur als { cx : 18, cy : 116 } zurück.

Da einige Geräte Kernzeichen aufweisen, ist die Summe der Ausdehnungen der einzelnen Glyphenindizes möglicherweise nicht gleich dem Umfang des gesamten Arrays von Glyphenindizes.

Die berechnete Zeichenfolgenbreite berücksichtigt den Von der SetTextCharacterExtra-Funktion festgelegten Interzeichenabstand.

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