GetTextExtentExTentExPointI-Funktion (wingdi.h)
Die GetTextExtentExPointI-Funktion ruft die Anzahl von Zeichen in einer angegebenen Zeichenfolge ab, die in ein angegebenes Leerzeichen passen, und füllt ein Array mit dem Textumfang für jedes dieser Zeichen. (Eine Textausdehnung ist der Abstand zwischen dem Anfang des Leerzeichens und einem Zeichen, das in das Leerzeichen passt.) Diese Informationen sind für Berechnungen mit Wortumbruch nützlich.
Syntax
BOOL GetTextExtentExPointI(
[in] HDC hdc,
[in] LPWORD lpwszString,
[in] int cwchString,
[in] int nMaxExtent,
[out] LPINT lpnFit,
[out] LPINT lpnDx,
[out] LPSIZE lpSize
);
Parameter
[in] hdc
Ein Handle für den Gerätekontext.
[in] lpwszString
Ein Zeiger auf ein Array von Glyphenindizes, für das Ausdehnungen abgerufen werden sollen.
[in] cwchString
Die Anzahl der Glyphen im Array, auf die der pgiIn-Parameter verweist.
[in] nMaxExtent
Die maximal zulässige Breite der formatierten Zeichenfolge in logischen Einheiten.
[out] lpnFit
Ein Zeiger auf eine ganze Zahl, die eine Anzahl der maximalen Zeichen empfängt, die in den durch den nMaxExtent-Parameter angegebenen Leerraum passen. Wenn der lpnFit-ParameterNULL ist, wird der nMaxExtent-Parameter ignoriert.
[out] lpnDx
Ein Zeiger auf ein Array ganzzahliger Zahlen, das partielle Glyphenausdehnungen empfängt. Jedes Element im Array gibt in logischen Einheiten den Abstand zwischen dem Anfang des Glyphenindizesarrays und einer der Glyphen an, die in den durch den nMaxExtent-Parameter angegebenen Raum passt. Obwohl dieses Array mindestens so viele Elemente wie Glyphenindizes aufweisen sollte, die durch den cgi-Parameter angegeben werden, füllt die Funktion das Array nur für so viele Glyphenindizes mit Ausdehnungen, wie vom lpnFit-Parameter angegeben sind. Wenn lpnFitNULL ist, berechnet die Funktion keine teiligen Zeichenfolgenbreiten.
[out] lpSize
Ein Zeiger auf eine SIZE-Struktur , die die Dimensionen des Glyphenindizesarrays in logischen Einheiten empfängt. Dieser Wert darf nicht NULL sein.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Wenn sowohl die Parameter lpnFit als auch alpDxNULL sind, entspricht das Aufrufen der GetTextExtentExtentExPointI-Funktion dem Aufrufen der GetTextExtentPointI-Funktion .
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |
Weitere Informationen
Schriftart- und Textfunktionen