GetThemeBackgroundContentRect, fonction (uxtheme.h)

Article
03/06/2024

Récupère la taille de la zone de contenu pour l’arrière-plan défini par le style visuel.

Syntaxe

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

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 la zone de contenu. Consultez Parties et états.

[in] iStateId

Type : int

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

[in] pBoundingRect

Type : LPCRECT

Pointeur vers une structure RECT qui contient le rectangle d’arrière-plan total, en coordonnées logiques. Il s’agit de la zone à l’intérieur des bordures ou des marges.

[out] pContentRect

Type : LPRECT

Pointeur vers une structure RECT qui reçoit le rectangle d’arrière-plan de la zone de contenu, en coordonnées logiques. Ce rectangle est calculé pour s’adapter à la zone de contenu.

Valeur retournée

Type : HRESULT

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

Remarques

Un style visuel 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 peut être placé sans remplacer les bordures d’arrière-plan.

Exemples

Lorsque vous appliquez un thème à une zone cliente entière d’une fenêtre, vous pouvez appeler GetClientRect pour récupérer cette zone dans un RECT, qui peut être transmis via le pointeur en tant que paramètre pContentRect à GetThemeBackgroundContentRect comme dans l’exemple suivant.

DWORD resultFlags = GetThemeAppProperties();
bool ctrlsAreThemed = ((resultFlags & STAP_ALLOW_CONTROLS) != 0);

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

GetThemeBackgroundExtent

Identificateurs de propriété

Référence

Partager via