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	Comctl32.dll (Version 6.0 oder höher)