Funzione SetBkColor (wingdi.h)
La funzione SetBkColor imposta il colore di sfondo corrente sul valore di colore specificato o sul colore fisico più vicino se il dispositivo non può rappresentare il valore di colore specificato.
Sintassi
COLORREF SetBkColor(
[in] HDC hdc,
[in] COLORREF color
);
Parametri
[in] hdc
Handle per il contesto del dispositivo.
[in] color
Nuovo colore di sfondo. Per impostare un valore COLORREF , utilizzare la macro RGB .
Valore restituito
Se la funzione ha esito positivo, il valore restituito specifica il colore di sfondo precedente come valore COLORREF .
Se la funzione ha esito negativo, il valore restituito è CLR_INVALID.
Commenti
Questa funzione riempie le lacune tra le linee in stile disegnate usando una penna creata dalla funzione CreatePen ; non riempie i gap tra le linee in stile disegnate utilizzando una penna creata dalla funzione ExtCreatePen . La funzione SetBkColor imposta anche i colori di sfondo per TextOut e ExtTextOut.
Se la modalità di sfondo è OPACA, il colore di sfondo viene utilizzato per riempire spazi tra linee in stile, spazi tra linee trattette in pennelli e celle di caratteri. Il colore di sfondo viene usato anche per convertire le bitmap dal colore al monocromatico e viceversa.
Esempio
Per un esempio, vedere "Esempio di Owner-Drawn voci di menu" in Uso dei menu.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wingdi.h (include Windows.h) |
| Libreria | Gdi32.lib |
| DLL | Gdi32.dll |