Funzione GetSysColor (winuser.h)

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ò essere uno dei valori seguenti.

Value	Meaning
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	Colore di evidenziazione 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	Colore di evidenziazione 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 a sinistra 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	Colore di evidenziazione 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	Colore di evidenziazione 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 pressione. Il colore di sfondo associato è COLOR_BTNFACE.
COLOR_CAPTIONTEXT 9	Testo nella didascalia, nella casella delle dimensioni e nella casella 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 a sinistra. 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 a sinistra. 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	Elemento selezionato 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 rilevato a caldo. Il colore di sfondo associato è COLOR_WINDOW.
COLOR_INACTIVEBORDER 11	Bordo finestra inattivo. Windows 10 o versione successiva: questo valore non è supportato.
COLOR_INACTIVECAPTION 3	Didascalia della finestra inattiva. Il colore di primo piano associato è COLOR_INACTIVECAPTIONTEXT. Specifica il colore a sinistra nella sfumatura di colore della barra del titolo di una finestra inattiva se l'effetto sfumatura è abilitato. Windows 10 o versione successiva: questo valore non è supportato.
COLOR_INACTIVECAPTIONTEXT 19	Colore del testo in una didascalia inattiva. Il colore di sfondo associato è COLOR_INACTIVECAPTION. Windows 10 o versione successiva: questo valore non è supportato.
COLOR_INFOBK 24	Colore di sfondo per i controlli descrizione comando. Il colore di primo piano associato è COLOR_INFOTEXT. Windows 10 o versione successiva: questo valore non è supportato.
COLOR_INFOTEXT 23	Colore del testo per i controlli descrizione comando. Il colore di sfondo associato è COLOR_INFOBK. Windows 10 o versione successiva: questo valore non è supportato.
COLOR_MENU 4	Sfondo del menu. Il colore di primo piano associato è COLOR_MENUTEXT. Windows 10 o versione successiva: questo valore non è supportato.
COLOR_MENUHILIGHT 29	Colore utilizzato per evidenziare le voci di menu quando il menu viene visualizzato come menu semplice (vedere SystemParametersInfo). La voce di menu evidenziata è evidenziata 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 della finestra popup del menu. 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 versione successiva: questo valore non è supportato.
COLOR_SCROLLBAR 0	Area grigia barra di scorrimento. Windows 10 o versione successiva: 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 versione successiva: questo valore non è supportato.
COLOR_WINDOWTEXT 8	Testo nelle finestre. Il colore di sfondo associato è COLOR_WINDOW.

Valore restituito

Tipo: DWORD

La funzione restituisce il valore del 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.

Osservazioni:

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

I colori di sistema per i display monocromatici vengono in genere interpretati come sfumature di grigio.

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

Color è un elemento visivo importante della maggior parte delle interfacce utente. Per linee guida sull'uso del colore nelle applicazioni, vedi 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 del tema a contrasto Windows 11 acquatiche.

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

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

Esempio	Values
	COLOR_WINDOWTEXT
	COLOR_HOTLIGHT
	COLOR_GRAYTEXT
	COLOR_HIGHLIGHTTEXT + HIGHLIGHT
	COLOR_BTNTEXT + COLOR_3DFACE

Esempi

Per un esempio, vedere SetSysColors.

Requisiti

Requisito	Value
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Header	winuser.h (includere Windows.h)
Biblioteca	User32.lib
DLL	User32.dll

Vedere anche

Commenti e suggerimenti

Questa pagina è stata utile?

Ultimo aggiornamento: 2026-09-28