Funzione GetSysColor (winuser.h)

Articolo
08/27/2023

Recupera il colore corrente dell'elemento di visualizzazione specificato. Gli elementi di visualizzazione sono le parti di una finestra e la visualizzazione visualizzata nella schermata di visualizzazione del sistema.

Sintassi

DWORD GetSysColor(
  [in] int nIndex
);

Parametri

[in] nIndex

Tipo: int

Elemento di visualizzazione il cui colore deve essere recuperato. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
COLOR_3DDKSHADOW 21	Ombreggiatura scura per gli elementi di visualizzazione tridimensionali. Windows 10 o versione successiva: questo valore non è supportato.
COLOR_3DFACE 15	Colore del viso per gli elementi di visualizzazione tridimensionali e per gli sfondi delle finestre di dialogo.
COLOR_3DHIGHLIGHT 20	Evidenziare il colore per gli elementi di visualizzazione tridimensionali (per i bordi che si affacciano sulla sorgente di luce). Windows 10 o versione successiva: questo valore non è supportato.
COLOR_3DHILIGHT 20	Evidenziare il colore per gli elementi di visualizzazione tridimensionali (per i bordi che si affacciano sulla sorgente di luce). Windows 10 o versione successiva: questo valore non è supportato.
COLOR_3DLIGHT 22	Colore chiaro per gli elementi di visualizzazione tridimensionali (per i bordi che si affacciano sulla sorgente di luce). Windows 10 o versione successiva: questo valore non è supportato.
COLOR_3DSHADOW 16	Colore ombreggiatura per gli elementi di visualizzazione tridimensionali (per i bordi che si affacciano lontano dalla sorgente di luce). Windows 10 o versione successiva: questo valore non è supportato.
COLOR_ACTIVEBORDER 10	Bordo finestra attivo. Windows 10 o versione successiva: questo valore non è supportato.
COLOR_ACTIVECAPTION 2	Barra del titolo della finestra attiva. Il colore di primo piano associato è COLOR_CAPTIONTEXT. Specifica il colore laterale sinistro nella sfumatura di colore della barra del titolo di una finestra attiva se l'effetto sfumatura è abilitato. Windows 10 o versione successiva: questo valore non è supportato.
COLOR_APPWORKSPACE 12	Colore di sfondo di più applicazioni MDI (Document Interface). Windows 10 o versione successiva: questo valore non è supportato.
COLOR_BACKGROUND 1	Desktop. Windows 10 o versione successiva: questo valore non è supportato.
COLOR_BTNFACE 15	Colore del viso per gli elementi di visualizzazione tridimensionali e per gli sfondi delle finestre di dialogo. Il colore di primo piano associato è COLOR_BTNTEXT. Windows 10 o versione successiva: questo valore non è supportato.
COLOR_BTNHIGHLIGHT 20	Evidenziare il colore per gli elementi di visualizzazione tridimensionali (per i bordi che si affacciano sulla sorgente di luce). Windows 10 o versione successiva: questo valore non è supportato.
COLOR_BTNHILIGHT 20	Evidenziare il colore per gli elementi di visualizzazione tridimensionali (per i bordi che si affacciano sulla sorgente di luce). Windows 10 o versione successiva: questo valore non è supportato.
COLOR_BTNSHADOW 16	Colore ombreggiatura per gli elementi di visualizzazione tridimensionali (per i bordi che si affacciano lontano dalla sorgente di luce). Windows 10 o versione successiva: questo valore non è supportato.
COLOR_BTNTEXT 18	Testo sui pulsanti di scelta. Il colore di sfondo associato è COLOR_BTNFACE.
COLOR_CAPTIONTEXT 9	Testo nella casella di didascalia, dimensioni e freccia della barra di scorrimento. Il colore di sfondo associato è COLOR_ACTIVECAPTION. Windows 10 o versione successiva: questo valore non è supportato.
COLOR_DESKTOP 1	Desktop. Windows 10 o versione successiva: questo valore non è supportato.
COLOR_GRADIENTACTIVECAPTION 27	Colore laterale destro nella sfumatura di colore della barra del titolo di una finestra attiva. COLOR_ACTIVECAPTION specifica il colore laterale sinistro. Usare SPI_GETGRADIENTCAPTIONS con la funzione SystemParametersInfo per determinare se l'effetto sfumatura è abilitato. Windows 10 o versione successiva: questo valore non è supportato.
COLOR_GRADIENTINACTIVECAPTION 28	Colore laterale destro nella sfumatura di colore della barra del titolo di una finestra inattiva. COLOR_INACTIVECAPTION specifica il colore laterale sinistro. Windows 10 o versione successiva: questo valore non è supportato.
COLOR_GRAYTEXT 17	Testo in grigio (disabilitato). Questo colore è impostato su 0 se il driver di visualizzazione corrente non supporta un colore grigio a tinta unita.
COLOR_HIGHLIGHT 13	Elementi selezionati in un controllo. Il colore di primo piano associato è COLOR_HIGHLIGHTTEXT.
COLOR_HIGHLIGHTTEXT 14	Testo degli elementi selezionati in un controllo. Il colore di sfondo associato è COLOR_HIGHLIGHT.
COLOR_HOTLIGHT 26	Colore per un collegamento ipertestuale o un elemento a traccia frequente. Il colore di sfondo associato è COLOR_WINDOW.
COLOR_INACTIVEBORDER 11	Bordo finestra inattiva. Windows 10 o maggiore: questo valore non è supportato.
COLOR_INACTIVECAPTION 3	Finestra inattiva didascalia. Il colore di primo piano associato è COLOR_INACTIVECAPTIONTEXT. Specifica il colore lato sinistro nella sfumatura di colore della barra del titolo di una finestra inattiva se l'effetto sfumatura è abilitato. Windows 10 o maggiore: questo valore non è supportato.
COLOR_INACTIVECAPTIONTEXT 19	Colore del testo in un didascalia inattivo. Il colore di sfondo associato è COLOR_INACTIVECAPTION. Windows 10 o maggiore: questo valore non è supportato.
COLOR_INFOBK 24	Colore di sfondo per i controlli della descrizione comando. Il colore di primo piano associato è COLOR_INFOTEXT. Windows 10 o maggiore: questo valore non è supportato.
COLOR_INFOTEXT 23	Colore di testo per i controlli della descrizione comando. Il colore di sfondo associato è COLOR_INFOBK. Windows 10 o maggiore: questo valore non è supportato.
COLOR_MENU 4	Sfondo del menu. Il colore di primo piano associato è COLOR_MENUTEXT. Windows 10 o maggiore: questo valore non è supportato.
COLOR_MENUHILIGHT 29	Colore utilizzato per evidenziare le voci di menu quando il menu viene visualizzato come menu flat (vedere SystemParametersInfo). La voce di menu evidenziata è descritta con COLOR_HIGHLIGHT. Windows 2000, Windows 10 o versione successiva: questo valore non è supportato.
COLOR_MENUBAR 30	Colore di sfondo per la barra dei menu quando i menu vengono visualizzati come menu flat (vedere SystemParametersInfo). Tuttavia, COLOR_MENU continua a specificare il colore di sfondo del menu popup. Windows 2000, Windows 10 o versione successiva: questo valore non è supportato.
COLOR_MENUTEXT 7	Testo nei menu. Il colore di sfondo associato è COLOR_MENU. Windows 10 o maggiore: questo valore non è supportato.
COLOR_SCROLLBAR 0	Area grigio barra di scorrimento. Windows 10 o maggiore: questo valore non è supportato.
COLOR_WINDOW 5	Sfondo finestra. I colori di primo piano associati sono COLOR_WINDOWTEXT e COLOR_HOTLITE.
COLOR_WINDOWFRAME 6	Cornice finestra. Windows 10 o maggiore: questo valore non è supportato.
COLOR_WINDOWTEXT 8	Testo in finestre. Il colore di sfondo associato è COLOR_WINDOW.

Valore restituito

Tipo: DWORD

La funzione restituisce il valore di colore rosso, verde, blu (RGB) dell'elemento specificato.

Se il parametro nIndex non è compreso nell'intervallo, il valore restituito è zero. Poiché zero è anche un valore RGB valido, non è possibile usare GetSysColor per determinare se un colore di sistema è supportato dalla piattaforma corrente. Usare invece la funzione GetSysColorBrush , che restituisce NULL se il colore non è supportato.

Commenti

Per visualizzare il componente del valore RGB, usare le macro GetRValue, GetGValue e GetBValue.

I colori di sistema per le visualizzazioni monocromatiche vengono in genere interpretati come sfumature di grigio.

Per disegnare con un pennello di colore di sistema, un'applicazione deve usare GetSysColorBrush(nIndex), invece di CreateSolidBrush(GetSysColor(nIndex)), perché GetSysColorBrush restituisce un pennello memorizzato nella cache, anziché allocare uno nuovo.

Color è un elemento visivo importante della maggior parte delle interfacce utente. Per linee guida sull'uso del colore nelle applicazioni, vedere Color - Win32 e Color in Windows 11.

colori di sistema Windows 10/11

Questa tabella mostra i valori supportati in Windows 10 e Windows 11 con valori di colore dal tema di contrasto Windows 11 acquatico.

Campione di colore	Descrizione
	COLOR_WINDOWSfondo di pagine, riquadri, popup e finestre. Associare COLOR_WINDOWTEXT
	COLOR_WINDOWTEXTIntestazioni, copia corpo, elenchi, testo segnaposto, bordi dell'app e delle finestre, qualsiasi interfaccia utente con cui non è possibile interagire. Associare COLOR_WINDOW
	COLOR_HOTLIGHTCollegamenti ipertestuali. Associare COLOR_WINDOW
	COLOR_GRAYTEXTInterfaccia utente inattiva (disabilitata). Associare COLOR_WINDOW
	COLOR_HIGHLIGHTTEXTColore di primo piano per il testo o l'interfaccia utente in selezionato, interagisce con (puntatore del mouse, premuto) o in corso. Coppia con COLOR_HIGHLIGHT
	COLOR_HIGHLIGHTSfondo o colore accentato per l'interfaccia utente selezionata, interagita con (puntatore del mouse, premuta) o in corso. Coppia con COLOR_HIGHLIGHTTEXT
	COLOR_BTNTEXTColore di primo piano per i pulsanti e qualsiasi interfaccia utente con cui è possibile interagire. Coppia con COLOR_3DFACE
	COLOR_3DFACEColore di sfondo per i pulsanti e qualsiasi interfaccia utente con cui è possibile interagire. Associare COLOR_BTNTEXT

Queste immagini mostrano come vengono visualizzati i colori quando vengono usati in uno sfondo impostato su COLOR_WINDOW.

Esempio	Valori
	COLOR_WINDOWTEXT
	COLOR_HOTLIGHT
	COLOR_GRAYTEXT
	COLOR_HIGHLIGHTTEXT + EVIDENZIAZIONE
	COLOR_BTNTEXT + COLOR_3DFACE

Esempio

Per un esempio, vedere SetSysColors.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll