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 |
|---|---|
|
Ombreggiatura scura per gli elementi di visualizzazione tridimensionali.
Windows 10 o versione successiva: questo valore non è supportato. |
|
Colore del viso per gli elementi di visualizzazione tridimensionali e per gli sfondi delle finestre di dialogo. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Bordo finestra attivo.
Windows 10 o versione successiva: questo valore non è supportato. |
|
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. |
|
Colore di sfondo di più applicazioni MDI (Document Interface).
Windows 10 o versione successiva: questo valore non è supportato. |
|
Desktop.
Windows 10 o versione successiva: questo valore non è supportato. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Testo sui pulsanti di scelta. Il colore di sfondo associato è COLOR_BTNFACE. |
|
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. |
|
Desktop.
Windows 10 o versione successiva: questo valore non è supportato. |
|
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. |
|
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. |
|
Testo in grigio (disabilitato). Questo colore è impostato su 0 se il driver di visualizzazione corrente non supporta un colore grigio a tinta unita. |
|
Elementi selezionati in un controllo. Il colore di primo piano associato è COLOR_HIGHLIGHTTEXT. |
|
Testo degli elementi selezionati in un controllo. Il colore di sfondo associato è COLOR_HIGHLIGHT. |
|
Colore per un collegamento ipertestuale o un elemento a traccia frequente. Il colore di sfondo associato è COLOR_WINDOW. |
|
Bordo finestra inattiva.
Windows 10 o maggiore: questo valore non è supportato. |
|
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. |
|
Colore del testo in un didascalia inattivo. Il colore di sfondo associato è COLOR_INACTIVECAPTION.
Windows 10 o maggiore: questo valore non è supportato. |
|
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. |
|
Colore di testo per i controlli della descrizione comando. Il colore di sfondo associato è COLOR_INFOBK.
Windows 10 o maggiore: questo valore non è supportato. |
|
Sfondo del menu. Il colore di primo piano associato è COLOR_MENUTEXT.
Windows 10 o maggiore: questo valore non è supportato. |
|
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. |
|
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. |
|
Testo nei menu. Il colore di sfondo associato è COLOR_MENU.
Windows 10 o maggiore: questo valore non è supportato. |
|
Area grigio barra di scorrimento.
Windows 10 o maggiore: questo valore non è supportato. |
|
Sfondo finestra. I colori di primo piano associati sono COLOR_WINDOWTEXT e COLOR_HOTLITE. |
|
Cornice finestra.
Windows 10 o maggiore: questo valore non è supportato. |
|
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 |
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per