GetSysColorBrush, fonction (winuser.h)
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) |