Fonction DrawThemeBackgroundEx (uxtheme.h)

Article
03/06/2024

[DrawThemeBackgroundEx est disponible pour une utilisation dans le fonctionnement

systèmes spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans

versions ultérieures.]

Dessine l’image d’arrière-plan définie par le style visuel pour la partie de contrôle spécifiée.

Syntaxe

HRESULT DrawThemeBackgroundEx(
  [in] HTHEME         hTheme,
  [in] HDC            hdc,
  [in] int            iPartId,
  [in] int            iStateId,
  [in] LPCRECT        pRect,
  [in] const DTBGOPTS *pOptions
);

Paramètres

[in] hTheme

Type : HTHEME

Gérez les données de thème spécifiées d’une fenêtre. Utilisez OpenThemeData pour créer un HTHEME.

[in] hdc

Type : HDC

HDC utilisé pour dessiner l’image d’arrière-plan définie par thème.

[in] iPartId

Type : int

Valeur de type int qui spécifie la partie à dessiner. Consultez Parties et états.

[in] iStateId

Type : int

Valeur de type int qui spécifie l’état du composant à dessiner. Consultez Parties et états.

[in] pRect

Type : const RECT*

Pointeur vers une structure RECT qui contient le rectangle, en coordonnées logiques, dans lequel l’image d’arrière-plan est dessinée.

[in] pOptions

Type : const DTBGOPTS*

Pointeur vers une structure DTBGOPTS qui contient des informations de découpage. Ce paramètre peut être défini sur NULL.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Les opérations de dessin sont mises à l’échelle pour s’adapter et ne pas dépasser le rectangle spécifié dans pRect.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uxtheme.h
Bibliothèque	UxTheme.lib
DLL	UxTheme.dll

Partager via