GetSysColorBrush, fonction (winuser.h)

Article
03/13/2024

La fonction GetSysColorBrush récupère un handle identifiant un pinceau logique qui correspond à l’index de couleur spécifié.

Syntaxe

HBRUSH GetSysColorBrush(
  [in] int nIndex
);

Paramètres

[in] nIndex

Index de couleur. Cette valeur correspond à la couleur utilisée pour peindre l’un des éléments de fenêtre. Consultez GetSysColor pour connaître les valeurs d’index de couleur système.

Valeur retournée

La valeur de retour identifie un pinceau logique si le paramètre nIndex est pris en charge par la plateforme actuelle. Sinon, elle retourne NULL.

Remarques

Un pinceau est une bitmap que le système utilise pour peindre les intérieurs des formes remplies. Une application peut récupérer les couleurs système actuelles en appelant la fonction GetSysColor . Une application peut définir les couleurs système actuelles en appelant la fonction SetSysColors .

Une application ne doit pas inscrire une classe de fenêtre pour une fenêtre à l’aide d’un pinceau système. Pour inscrire une classe de fenêtre avec une couleur système, consultez la documentation du membre hbrBackground des structures WNDCLASS ou WNDCLASSEX .

Les pinceaux de couleur système effectuent le suivi des modifications apportées aux couleurs système. En d’autres termes, lorsque l’utilisateur modifie une couleur système, le pinceau de couleur système associé passe automatiquement à la nouvelle couleur.

Pour peindre avec un pinceau de couleur système, une application doit utiliser GetSysColorBrush (nIndex) au lieu de CreateSolidBrush ( GetSysColor (nIndex)), car GetSysColorBrush renvoie un pinceau mis en cache au lieu d’en allouer un nouveau.

Les pinceaux de couleur système appartiennent au système. Vous n’avez donc pas besoin de les détruire. Bien que vous n’ayez pas besoin de supprimer le pinceau logique retourné par GetSysColorBrush , l’appel de DeleteObject n’entraîne aucun préjudice.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-gui-l1-1-1 (introduit dans Windows 8.1)