DrawThemeTextEx-Funktion (uxtheme.h)

Zeichnet Text mit der Farbe und Schriftart, die durch den visuellen Stil definiert wird. Erweitert DrawThemeText , indem zusätzliche Textformatoptionen zugelassen werden.

Syntax

HRESULT DrawThemeTextEx(
  [in]      HTHEME        hTheme,
  [in]      HDC           hdc,
  [in]      int           iPartId,
  [in]      int           iStateId,
  [in]      LPCWSTR       pszText,
  [in]      int           cchText,
  [in]      DWORD         dwTextFlags,
  [in, out] LPRECT        pRect,
  [in]      const DTTOPTS *pOptions
);

Parameter

[in] hTheme

Typ: HTHEME

Handle für die angegebenen Designdaten eines Fensters. Verwenden Sie OpenThemeData , um eine HTHEME zu erstellen.

[in] hdc

Typ: HDC

HDC, das zum Zeichnen verwendet werden soll.

[in] iPartId

Typ: int

Das Steuerelementteil, in dem das gewünschte Erscheinungsbild für den Text gespeichert ist. Weitere Informationen finden Sie unter Teile und Zustände. Wenn der Wert 0 lautet, wird der Text in der Standardschriftart oder in einer im Gerätekontext ausgewählten Schriftart gezeichnet.

[in] iStateId

Typ: int

Der Steuerelementzustand, in dem das gewünschte Erscheinungsbild für den Text gespeichert ist. Weitere Informationen finden Sie unter Teile und Zustände.

[in] pszText

Typ: LPCWSTR

Zeiger auf eine Zeichenfolge, die den zu zeichnenden Text enthält.

[in] cchText

Typ: int

Wert des Typs int , der die Anzahl der zu zeichnenden Zeichen enthält. Wenn der Parameter auf -1 festgelegt ist, werden alle Zeichen in der Zeichenfolge gezeichnet.

[in] dwTextFlags

Typ: DWORD

DWORD , das einen oder mehrere Werte enthält, die die Formatierung der Zeichenfolge angeben. Mögliche Parameterwerte finden Sie unter Formatwerte .

[in, out] pRect

Typ: LPRECT

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

[in] pOptions

Typ: const DTTOPTS*

Eine DTTOPTS-Struktur , die zusätzliche Formatierungsoptionen definiert, die auf den gezeichneten Text angewendet werden.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die Funktion verwendet immer die Designschriftart für den angegebenen Teil und Zustand, sofern eine definiert ist. Andernfalls wird die schriftart verwendet, die derzeit im Gerätekontext ausgewählt ist. Um herauszufinden, ob eine Designschriftart definiert ist, können Sie GetThemeFont oder GetThemePropertyOrigin mit TMT_FONT als Eigenschaftsbezeichner aufrufen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uxtheme.h
Bibliothek	UxTheme.lib
DLL	UxTheme.dll