GetThemeBackgroundRegion, fonction (uxtheme.h)

Calcule la région pour un arrière-plan normal ou partiellement transparent délimité par un rectangle spécifié.

Syntaxe

HRESULT GetThemeBackgroundRegion(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCRECT pRect,
  [out] HRGN    *pRegion
);

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 à intégrer. Le contrôleur de domaine utilise la mise à l’échelle des points par pouce (PPP). Ce paramètre peut être défini sur NULL.

[in] iPartId

Type : int

Valeur de type int qui spécifie la partie qui contient la région. Consultez Parties et états.

[in] iStateId

Type : int

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

[in] pRect

Type : LPCRECT

Pointeur vers une structure RECT qui contient, en coordonnées logiques, le rectangle spécifié utilisé pour calculer la région.

[out] pRegion

Type : HRGN*

Pointeur vers le handle vers la région calculée.

Valeur retournée

Type : HRESULT

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

Remarques

Le handle de région retourné par cette fonction doit être libéré lorsqu’il n’est plus nécessaire, à l’aide de DeleteObject.

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

Voir aussi

Autres ressources

Identificateurs de propriété

Référence

Régions