Funzione GetSysColorBrush (winuser.h)
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) |