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. Es 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 zum Gerätekontext, in dem gezeichnet 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-beendet sein.

Wenn dwDTFormat DT_MODIFYSTRING enthält, kann die Funktion bis zu vier zusätzliche Zeichen zu dieser Zeichenfolge hinzufügen. Der Puffer, der die Zeichenfolge enthält, sollte groß genug sein, um diese zusätzlichen Zeichen zu berücksichtigen.

cchText [in]

Typ: int

Die Länge der Zeichenfolge, die durch lpchText verweist. Wenn cchText -1 ist, wird der lpchText-Parameter als Zeiger auf eine null-beendete Zeichenfolge angenommen, und DrawTextEx berechnet die Zeichenanzahl automatisch.

lprc [in, out]

Typ: LPRECT

Ein Zeiger auf eine RECT-Struktur , die das Rechteck enthält, in logischen Koordinaten, in denen der Text formatiert werden soll.

dwDTFormat [in]

Typ: UINT

Die Formatierungsoptionen. Eine vollständige Liste der Optionen finden Sie in der Dokumentation für 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 verläuft, 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 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 es zu verwenden, müssen Sie GetProcAddress und das Ordinal 416 von ComCtl32.dll zum Abrufen eines Funktionszeigers verwenden.

Weitere Hinweise finden Sie unter DrawTextEx.

Requirements (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)