ExtTextOutWrap-Funktion
[ExtTextOutWrap ist über Windows XP mit Service Pack 2 (SP2) verfügbar. Es kann geändert oder in nachfolgenden Versionen nicht verfügbar sein. Es wird empfohlen, extTextOut stattdessen direkt zu verwenden.]
Zeichnet Text mit der aktuell ausgewählten Schriftart, Hintergrundfarbe und Textfarbe. Optional können Sie Dimensionen angeben, die für Clipping, Deckkraft oder beides verwendet werden sollen. Diese Funktion umschließt einen Aufruf von ExtTextOut.
Syntax
BOOL ExtTextOutWrap(
_In_ HDC hdc,
_In_ int X,
_In_ int Y,
_In_ UINT uOptions,
_In_ const RECT *lprc,
_In_ LPCTSTR lpString,
_In_ UINT cbCount,
_In_ const INT *lpDx
);
Parameter
-
hdc [in]
-
Typ: HDC
Ein Handle für den Gerätekontext.
-
X [in]
-
Typ: int
Die x-Koordinate in logischen Koordinaten des Bezugspunkts, der zum Positionieren der Zeichenfolge verwendet wird.
-
Y [in]
-
Typ: int
Die y-Koordinate in logischen Koordinaten des Bezugspunkts, der zum Positionieren der Zeichenfolge verwendet wird.
-
uOptions [in]
-
Typ: UINT
Werte, die angeben, wie das anwendungsdefinierte Rechteck verwendet werden soll. Eine vollständige Liste der Optionen finden Sie unter ExtTextOut .
-
lprc [in]
-
Typ: const RECT*
Ein Zeiger auf eine optionale RECT-Struktur , die die Dimensionen eines Rechtecks in logischen Koordinaten angibt, das für Clipping, Deckkraft oder beides verwendet wird.
-
lpString [in]
-
Typ: LPCTSTR
Ein Zeiger auf einen Puffer, der den zu zeichnenden Text enthält. Die Zeichenfolge muss nicht mit Null beendet werden, da cbCount die Länge der Zeichenfolge angibt.
-
cbCount [in]
-
Typ: UINT
Die Länge der Zeichenfolge in Bytes, auf die lpString verweist.
-
lpDx [in]
-
Typ: const INT*
Ein Zeiger auf ein optionales Array von Werten, die den Abstand zwischen den Ursprüngen benachbarter Zeichenzellen angeben. Beispielsweise trennen logische Einheiten lpDx[x] die Ursprünge der Zeichenzelle x und der Zeichenzelle (x + 1).
Rückgabewert
Typ: BOOL
Gibt einen Wert ungleich Null zurück, wenn die Zeichenfolge erfolgreich gezeichnet wurde. Wenn die ANSI-Version von ExtTextOut jedoch mit ETO_GLYPH_INDEX aufgerufen wird, gibt die Funktion TRUE zurück, obwohl die Funktion nichts tut.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Bemerkungen
ExtTextOutWrap wird nicht nach Namen exportiert oder in einer öffentlichen Headerdatei deklariert. Um sie zu verwenden, müssen Sie GetProcAddress verwenden und die Ordnungszahl 417 von ComCtl32.dll anfordern, um einen Funktionszeiger abzurufen.
Weitere Hinweise finden Sie unter ExtTextOut.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| DLL |
|