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