DrawTextWrap-Funktion
[DrawTextWrap ist über Windows XP mit Service Pack 2 (SP2) verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Es wird empfohlen, stattdessen DrawText direkt zu verwenden.]
Zeichnet formatierten Text im angegebenen Rechteck. Es formatiert den Text gemäß der angegebenen Methode (Erweitern von Registerkarten, Rechtfertigungszeichen, Zeilenbruchlinien usw.). Diese Funktion umschließt einen Aufruf von DrawText.
Syntax
int WINAPI DrawTextWrap(
_In_ HDC hdc,
_Inout_ LPCTSTR lpString,
_In_ int nCount,
_Inout_ LPRECT lpRect,
_In_ UINT uFormat,
_In_ LPDRAWTEXTPARAMS lpDTParams
);
Parameter
-
hdc [in]
-
Typ: HDC
Ein Handle für den Gerätekontext.
-
lpString [ein, aus]
-
Typ: LPCTSTR
Ein Zeiger auf einen Puffer, der den zu zeichnenden Text enthält. Wenn der nCount-Parameter -1 ist, muss die Zeichenfolge null-beendet sein.
Wenn uFormat 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.
-
nCount [in]
-
Typ: int
Die Länge der Zeichenfolge, auf die lpString verweist. Wenn nCount -1 ist, wird angenommen, dass der lpString-Parameter ein Zeiger auf eine null-endende Zeichenfolge ist, und DrawText berechnet die Zeichenanzahl automatisch.
-
lpRect [ein, aus]
-
Typ: LPRECT
Ein Zeiger auf eine RECT-Struktur , die das Rechteck in logischen Koordinaten enthält, in dem der Text formatiert werden soll.
-
uFormat [in]
-
Typ: UINT
Die Formatierungsoptionen. Eine vollständige Liste der Optionen finden Sie in der Dokumentation zu DrawText .
-
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 fehlschlägt, ist der Rückgabewert 0.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Bemerkungen
DrawTextWrap wird nicht nach Name exportiert oder in einem öffentlichen Header deklariert. Zum Verwenden müssen Sie GetProcAddress verwenden und ordnungszahl 415 von ComCtl32.dll anfordern, um einen Funktionszeiger abzurufen.
Weitere Hinweise finden Sie unter DrawText.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| DLL |
|