GetThemeBackgroundExtent, fonction (uxtheme.h)

Article
08/26/2023

Calcule la taille et l’emplacement de l’arrière-plan, définis par le style visuel, en fonction de la zone de contenu.

Syntaxe

HRESULT GetThemeBackgroundExtent(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCRECT pContentRect,
  [out] LPRECT  pExtentRect
);

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 à utiliser lors du dessin. Ce paramètre peut être défini sur NULL.

[in] iPartId

Type : int

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

[in] iStateId

Type : int

Valeur de type int qui spécifie l’état de la partie qui contient le contenu. Consultez Parties et états.

[in] pContentRect

Type : LPCRECT

Pointeur vers une structure RECT qui contient le rectangle d’arrière-plan de contenu, en coordonnées logiques. Ce rectangle est retourné à partir de GetThemeBackgroundContentRect.

[out] pExtentRect

Type : LPRECT

Pointeur vers une structure RECT qui reçoit le rectangle d’arrière-plan, en coordonnées logiques. Ce rectangle est basé sur le pContentRect.

Valeur retournée

Type : HRESULT

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

Remarques

Un thème peut définir une zone de contenu dans chaque image d’arrière-plan. Il s’agit de la zone où le contenu tel que le texte et les icônes peuvent être placés sans remplacer les bordures d’arrière-plan.

Configuration requise


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

GetThemeBackgroundContentRect

Identificateurs de propriété

Référence

Partager via