Partager via


GetSysColor, fonction (winuser.h)

Récupère la couleur actuelle de l’élément d’affichage spécifié. Les éléments d’affichage sont les parties d’une fenêtre et l’affichage qui s’affichent sur l’écran d’affichage du système.

Syntaxe

DWORD GetSysColor(
  [in] int nIndex
);

Paramètres

[in] nIndex

Type : int

Élément d’affichage dont la couleur doit être récupérée. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
COLOR_3DDKSHADOW
21
Ombre foncée pour les éléments d’affichage tridimensionnels.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_3DFACE
15
Couleur du visage pour les éléments d’affichage tridimensionnels et pour les arrière-plans de boîte de dialogue.
COLOR_3DHIGHLIGHT
20
Couleur de mise en surbrillance pour les éléments d’affichage tridimensionnels (pour les bords face à la source de lumière.)

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_3DHILIGHT
20
Couleur de mise en surbrillance pour les éléments d’affichage tridimensionnels (pour les bords face à la source de lumière.)

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_3DLIGHT
22
Couleur claire pour les éléments d’affichage tridimensionnels (pour les bords face à la source de lumière.)

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_3DSHADOW
16
Couleur d’ombre pour les éléments d’affichage à trois dimensions (pour les bords orientés loin de la source de lumière).

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_ACTIVEBORDER
10
Bordure de fenêtre active.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_ACTIVECAPTION
2
Barre de titre de la fenêtre active.

La couleur de premier plan associée est COLOR_CAPTIONTEXT.

Spécifie la couleur du côté gauche dans le dégradé de couleur de la barre de titre d’une fenêtre active si l’effet de dégradé est activé.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_APPWORKSPACE
12
Couleur d’arrière-plan des applications MDI (Multiple Document Interface).

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_BACKGROUND
1
Bureau.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_BTNFACE
15
Couleur du visage pour les éléments d’affichage tridimensionnels et pour les arrière-plans de boîte de dialogue. La couleur de premier plan associée est COLOR_BTNTEXT.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_BTNHIGHLIGHT
20
Couleur de mise en surbrillance pour les éléments d’affichage tridimensionnels (pour les bords face à la source de lumière.)

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_BTNHILIGHT
20
Couleur de mise en surbrillance pour les éléments d’affichage tridimensionnels (pour les bords face à la source de lumière.)

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_BTNSHADOW
16
Couleur d’ombre pour les éléments d’affichage à trois dimensions (pour les bords orientés loin de la source de lumière).

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_BTNTEXT
18
Texte sur les boutons pousseurs. La couleur d’arrière-plan associée est COLOR_BTNFACE.
COLOR_CAPTIONTEXT
9
Texte dans légende, zone de taille et zone de flèche de la barre de défilement. La couleur d’arrière-plan associée est COLOR_ACTIVECAPTION.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_DESKTOP
1
Bureau.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_GRADIENTACTIVECAPTION
27
Couleur de droite dans le dégradé de couleur de la barre de titre d’une fenêtre active. COLOR_ACTIVECAPTION spécifie la couleur du côté gauche. Utilisez SPI_GETGRADIENTCAPTIONS avec la fonction SystemParametersInfo pour déterminer si l’effet de dégradé est activé.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_GRADIENTINACTIVECAPTION
28
Couleur du côté droit dans le dégradé de couleur de la barre de titre d’une fenêtre inactive. COLOR_INACTIVECAPTION spécifie la couleur du côté gauche.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_GRAYTEXT
17
Texte grisé (désactivé). Cette couleur est définie sur 0 si le pilote d’affichage actuel ne prend pas en charge une couleur gris unie.
COLOR_HIGHLIGHT
13
Élément(s) sélectionné(s) dans un contrôle. La couleur de premier plan associée est COLOR_HIGHLIGHTTEXT.
COLOR_HIGHLIGHTTEXT
14
Texte du ou des éléments sélectionnés dans un contrôle. La couleur d’arrière-plan associée est COLOR_HIGHLIGHT.
COLOR_HOTLIGHT
26
Couleur d’un lien hypertexte ou d’un élément suivi à chaud. La couleur d’arrière-plan associée est COLOR_WINDOW.
COLOR_INACTIVEBORDER
11
Bordure de fenêtre inactive.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_INACTIVECAPTION
3
Fenêtre inactive légende.

La couleur de premier plan associée est COLOR_INACTIVECAPTIONTEXT.

Spécifie la couleur du côté gauche dans le dégradé de couleur de la barre de titre d’une fenêtre inactive si l’effet de dégradé est activé.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_INACTIVECAPTIONTEXT
19
Couleur du texte dans un légende inactif. La couleur d’arrière-plan associée est COLOR_INACTIVECAPTION.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_INFOBK
24
Couleur d’arrière-plan des contrôles d’info-bulle. La couleur de premier plan associée est COLOR_INFOTEXT.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_INFOTEXT
23
Couleur du texte pour les contrôles d’info-bulle. La couleur d’arrière-plan associée est COLOR_INFOBK.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_MENU
4
Arrière-plan du menu. La couleur de premier plan associée est COLOR_MENUTEXT.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_MENUHILIGHT
29
Couleur utilisée pour mettre en surbrillance les éléments de menu lorsque le menu apparaît sous la forme d’un menu plat (voir SystemParametersInfo). L’élément de menu mis en surbrillance est décrit avec COLOR_HIGHLIGHT.

Windows 2000, Windows 10 ou version ultérieure : cette valeur n’est pas prise en charge.

COLOR_MENUBAR
30
Couleur d’arrière-plan de la barre de menus lorsque les menus apparaissent sous forme de menus plats (voir SystemParametersInfo). Toutefois, COLOR_MENU continue de spécifier la couleur d’arrière-plan de la fenêtre contextuelle du menu.

Windows 2000, Windows 10 ou version ultérieure : cette valeur n’est pas prise en charge.

COLOR_MENUTEXT
7
Texte dans les menus. La couleur d’arrière-plan associée est COLOR_MENU.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_SCROLLBAR
0
Zone grise de la barre de défilement.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_WINDOW
5
Arrière-plan de la fenêtre. Les couleurs de premier plan associées sont COLOR_WINDOWTEXT et COLOR_HOTLITE.
COLOR_WINDOWFRAME
6
Cadre de fenêtre.

Windows 10 ou supérieure : cette valeur n’est pas prise en charge.

COLOR_WINDOWTEXT
8
Texte dans les fenêtres. La couleur d’arrière-plan associée est COLOR_WINDOW.

Valeur retournée

Type : DWORD

La fonction retourne la valeur de couleur rouge, vert, bleu (RVB) de l’élément donné.

Si le paramètre nIndex est hors plage, la valeur de retour est zéro. Étant donné que zéro est également une valeur RVB valide, vous ne pouvez pas utiliser GetSysColor pour déterminer si une couleur système est prise en charge par la plateforme actuelle. Utilisez plutôt la fonction GetSysColorBrush , qui retourne NULL si la couleur n’est pas prise en charge.

Remarques

Pour afficher le composant de la valeur RVB, utilisez les macros GetRValue, GetGValue et GetBValue .

Les couleurs système des écrans monochromes sont généralement interprétées comme des nuances de gris.

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

La couleur est un élément visuel important de la plupart des interfaces utilisateur. Pour obtenir des instructions sur l’utilisation de la couleur dans vos applications, consultez Couleur - Win32 et Couleur dans Windows 11.

couleurs système Windows 10/11

Ce tableau montre les valeurs prises en charge dans Windows 10 et Windows 11 avec des valeurs de couleur du thème de contraste aquatique Windows 11.

Nuancier de couleur Description

COLOR_WINDOWArrière-plan des pages, des volets, des fenêtres contextuelles et des fenêtres.

Coupler avec COLOR_WINDOWTEXT

COLOR_WINDOWTEXTEn-têtes, copie de corps, listes, texte d’espace réservé, bordures d’application et de fenêtre, toute interface utilisateur avec laquelle vous ne pouvez pas interagir.

Coupler avec COLOR_WINDOW

COLOR_HOTLIGHTHyperliens.

Coupler avec COLOR_WINDOW

COLOR_GRAYTEXTInterface utilisateur inactive (désactivée).

Coupler avec COLOR_WINDOW

COLOR_HIGHLIGHTTEXTCouleur de premier plan pour le texte ou l’interface utilisateur qui est sélectionné, interagissant avec (pointeur, appuyé) ou en cours.

Association avec COLOR_HIGHLIGHT

COLOR_HIGHLIGHTCouleur d’arrière-plan ou d’accentuation de l’interface utilisateur sélectionnée, interagissant avec (pointeur, enfoncée) ou en cours.

Coupler avec COLOR_HIGHLIGHTTEXT

COLOR_BTNTEXTCouleur de premier plan pour les boutons et toute interface utilisateur avec laquelle vous pouvez interagir.

Coupler avec COLOR_3DFACE

COLOR_3DFACECouleur d’arrière-plan des boutons et de toute interface utilisateur avec laquelle vous pouvez interagir.

Coupler avec COLOR_BTNTEXT

Ces images montrent comment les couleurs apparaissent lorsqu’elles sont utilisées sur un jeu d’arrière-plan pour COLOR_WINDOW.

Exemple Valeurs
Fenêtre avec du texte utilisant la couleur du texte de la fenêtre. COLOR_WINDOWTEXT
Fenêtre avec du texte de lien hypertexte utilisant la couleur de lumière chaude. COLOR_HOTLIGHT
Fenêtre avec du texte inactif utilisant la couleur de texte gris. COLOR_GRAYTEXT
Fenêtre avec du texte utilisant la couleur du texte de surbrillance sur la couleur de surbrillance. COLOR_HIGHLIGHTTEXT + SURBRILLANCE
Fenêtre avec un bouton utilisant la couleur de visage 3D et le texte du bouton utilisant la couleur de texte du bouton. COLOR_BTNTEXT + COLOR_3DFACE

Exemples

Pour obtenir un exemple, consultez SetSysColors.

Configuration requise

   
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

Voir aussi

CreateSolidBrush

GetSysColorBrush

SetSysColors

SystemParametersInfo