SetWindowTheme, fonction (uxtheme.h)

Article
02/21/2025

Fait en sorte qu’une fenêtre utilise un ensemble différent d’informations de style visuel que sa classe utilise normalement.

Syntaxe

HRESULT SetWindowTheme(
  [in] HWND    hwnd,
  [in] LPCWSTR pszSubAppName,
  [in] LPCWSTR pszSubIdList
);

Paramètres

[in] hwnd

Type : HWND

Gérez la fenêtre dont les informations de style visuel doivent être modifiées.

[in] pszSubAppName

Type : LPCWSTR

Pointeur vers une chaîne qui contient le nom de l’application à utiliser à la place du nom de l’application appelante. Si ce paramètre est NULL, le nom de l’application appelante est utilisé.

[in] pszSubIdList

Type : LPCWSTR

Pointeur vers une chaîne qui contient une liste séparée par des points-virgules de noms CLSID à utiliser à la place de la liste réelle passée par la classe de la fenêtre. Si ce paramètre est NULL, la liste d’ID de la classe appelante est utilisée.

Valeur de retour

Type : HRESULT

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

Remarques

Le gestionnaire de thèmes conserve les associations pszSubAppName et pszSubIdList au cours de la durée de vie de la fenêtre, même si les styles visuels changent par la suite. La fenêtre est envoyée un message WM_THEMECHANGED à la fin d’un appel SetWindowTheme, afin que le nouveau style visuel soit trouvé et appliqué.

Lorsque pszSubAppName et pszSubIdList sont NULL, le gestionnaire de thèmes supprime les associations précédemment appliquées. Vous pouvez empêcher l’application de styles visuels à une fenêtre spécifiée en spécifiant une chaîne vide (L" »), qui ne correspond à aucune entrée de section.

Exemples

L’exemple de code suivant donne un contrôle d’affichage de liste à l’apparence d’une liste de l’Explorateur Windows :

SetWindowTheme(hwndList, L"Explorer", NULL);

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	uxtheme.h
bibliothèque	UxTheme.lib
DLL	UxTheme.dll

Partager via