DrawTextExPrivWrap-Funktion
[DrawTextExPrivWrap ist über Windows XP mit Service Pack 2 (SP2) verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Stattdessen wird empfohlen, DrawTextEx direkt zu verwenden.]
Zeichnet formatierten Text im angegebenen Rechteck. Diese Funktion umschließt einen Aufruf von DrawTextEx.
Syntax
int WINAPI DrawTextExPrivWrap(
_In_ HDC hdc,
_Inout_ LPTSTR lpchText,
_In_ int cchText,
_Inout_ LPRECT lprc,
_In_ UINT dwDTFormat,
_In_ LPDRAWTEXTPARAMS lpDTParams
);
Parameter
-
hdc [ In]
-
Typ: HDC
Ein Handle für den Gerätekontext, in dem ge zeichnen werden soll.
-
lpchText [ in, out]
-
Typ: LPTSTR
Ein Zeiger auf einen Puffer, der den zu zeichnenden Text enthält. Wenn der cchText-Parameter -1 ist, muss die Zeichenfolge null-terminiert sein.
Wenn dwDTFormat DT MODIFYSTRING enthält, kann die Funktion dieser Zeichenfolge bis zu _ vier zusätzliche Zeichen hinzufügen. Der Puffer, der die Zeichenfolge enthält, sollte groß genug sein, um diese zusätzlichen Zeichen aufnehmen zu können.
-
cchText [ In]
-
Typ: int
Die Länge der Zeichenfolge, auf die lpchText zeigt. Wenn cchText -1 ist, wird davon ausgegangen, dass der lpchText-Parameter ein Zeiger auf eine auf NULL beendete Zeichenfolge ist, und DrawTextEx berechnet die Zeichenanzahl automatisch.
-
lprc [ in, out]
-
Typ: LPRECT
Ein Zeiger auf eine RECT-Struktur, die das Rechteck in logischen Koordinaten enthält, in dem der Text formatiert werden soll.
-
dwDTFormat [ In]
-
Typ: UINT
Die Formatierungsoptionen. Eine vollständige Liste der Optionen finden Sie in der Dokumentation zu DrawTextEx.
-
lpDTParams [ In]
-
Typ: LPDRAWTEXTPARAMS
Ein Zeiger auf eine DRAWTEXTPARAMS-Struktur, die zusätzliche Formatierungsoptionen angibt. Dieser Parameter kann NULL sein.
Rückgabewert
Typ: int
Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Texthöhe in logischen Einheiten. Wenn DT _ VCENTER oder DT _ BOTTOM angegeben ist, ist der Rückgabewert der Offset vom obersten Member von lprc bis zum unteren Rand des gezeichneten Texts.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Bemerkungen
DrawTextExPrivWrap wird nicht nach Namen exportiert oder in einer öffentlichen Headerdatei deklariert. Um sie zu verwenden, müssen Sie GetProcAddress verwenden und ordinal 416 von ComCtl32.dll anfordern, um einen Funktionszeiger zu erhalten.
Weitere Hinweise finden Sie unter DrawTextEx.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| DLL |
|