Freigeben über


DrawThemeBackgroundEx-Funktion (uxtheme.h)

[DrawThemeBackgroundEx ist für die Verwendung im Betrieb verfügbar.

Systeme, die im Abschnitt Anforderungen angegeben sind. Sie kann in geändert oder nicht verfügbar sein.

nachfolgende Versionen.]

Zeichnet das Hintergrundbild, das durch den visuellen Stil für das angegebene Steuerelementteil definiert wird.

Syntax

HRESULT DrawThemeBackgroundEx(
  [in] HTHEME         hTheme,
  [in] HDC            hdc,
  [in] int            iPartId,
  [in] int            iStateId,
  [in] LPCRECT        pRect,
  [in] const DTBGOPTS *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 zum Zeichnen des designdefinierten Hintergrundbilds.

[in] iPartId

Typ: int

Wert vom Typ int , der den zu zeichnenden Teil angibt. Weitere Informationen finden Sie unter Teile und Zustände.

[in] iStateId

Typ: int

Der Wert vom Typ int , der den Zustand des zu zeichnenden Teils angibt. Weitere Informationen finden Sie unter Teile und Zustände.

[in] pRect

Typ: const RECT*

Zeiger auf eine RECT-Struktur , die das Rechteck in logischen Koordinaten enthält, in dem das Hintergrundbild gezeichnet wird.

[in] pOptions

Typ: const DTBGOPTS*

Zeiger auf eine DTBGOPTS-Struktur , die Clippinginformationen enthält. Dieser Parameter kann auf NULL festgelegt werden.

Rückgabewert

Typ: HRESULT

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

Hinweise

Zeichnungsvorgänge werden entsprechend skaliert, um das in pRect angegebene Rechteck nicht zu überschreiten.

Anforderungen

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