Condividi tramite


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ò 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
Finestra con testo con il colore del testo della finestra. COLOR_WINDOWTEXT
Finestra con testo del collegamento ipertestuale utilizzando il colore chiaro caldo. COLOR_HOTLIGHT
Finestra con testo inattivo utilizzando il colore grigio del testo. COLOR_GRAYTEXT
Finestra con testo che usa il colore del testo di evidenziazione sul colore di evidenziazione. COLOR_HIGHLIGHTTEXT + EVIDENZIAZIONE
Finestra con un pulsante utilizzando il colore del viso 3d e il testo del pulsante usando il colore del testo del pulsante. 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

Vedi anche

CreateSolidBrush

GetSysColorBrush

SetSysColors

Systemparametersinfo