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 gezeichnet werden soll.
-
lpchText [ein, aus]
-
Typ: LPTSTR
Ein Zeiger auf einen Puffer, der den zu zeichnenden Text enthält. Wenn der cchText-Parameter -1 ist, muss die Zeichenfolge null-beendet 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 aufzunehmen.
-
cchText [in]
-
Typ: int
Die Länge der Zeichenfolge, auf die von lpchText verwiesen wird. Wenn cchText -1 ist, wird angenommen, dass der lpchText-Parameter ein Zeiger auf eine null-endende 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 wird, ist der Rückgabewert der Offset vom oberen Element von lprc 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 Name exportiert oder in einer öffentlichen Headerdatei deklariert. Zum Verwenden müssen Sie GetProcAddress verwenden und die Ordnungszahl 416 von ComCtl32.dll anfordern, um einen Funktionszeiger abzurufen.
Weitere Hinweise finden Sie unter DrawTextEx.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| DLL |
|