Funzione GetSysColorBrush (winuser.h)

Articolo
08/27/2023

La funzione GetSysColorBrush recupera un handle che identifica un pennello logico che corrisponde all'indice di colore specificato.

Sintassi

HBRUSH GetSysColorBrush(
  [in] int nIndex
);

Parametri

[in] nIndex

Indice di colore. Questo valore corrisponde al colore utilizzato per disegnare uno degli elementi della finestra. Vedere GetSysColor per i valori di indice dei colori di sistema.

Valore restituito

Il valore restituito identifica un pennello logico se il parametro nIndex è supportato dalla piattaforma corrente. In caso contrario, restituisce NULL.

Commenti

Un pennello è una bitmap usata dal sistema per dipingere gli interni delle forme riempite. Un'applicazione può recuperare i colori di sistema correnti chiamando la funzione GetSysColor . Un'applicazione può impostare i colori di sistema correnti chiamando la funzione SetSysColors .

Un'applicazione non deve registrare una classe finestra per una finestra usando un pennello di sistema. Per registrare una classe di finestra con un colore di sistema, vedere la documentazione del membro hbrBackground delle strutture WNDCLASS o WNDCLASSEX.

I pennelli di colore di sistema tengono traccia delle modifiche apportate ai colori del sistema. In altre parole, quando l'utente modifica un colore di sistema, il pennello di colore del sistema associato cambia automaticamente al nuovo colore.

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

I pennelli di colore di sistema sono di proprietà del sistema in modo che non sia necessario distruggerli. Anche se non è necessario eliminare il pennello logico restituito da GetSysColorBrush , non si verifica alcun danno chiamando DeleteObject.

Requisiti

Requisito	Valore
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
Set di API	ext-ms-win-ntuser-gui-l1-1-1 (introdotto in Windows 8.1)