GetThemeBackgroundContentRect, fonction (uxtheme.h)
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
Référence
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour