Funzione SetBkColor (wingdi.h)

Articolo
08/27/2023

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