Funzione SetDCBrushColor (wingdi.h)

La funzione SetDCBrushColor imposta il colore corrente del pennello del contesto di dispositivo (DC) sul valore di colore specificato. Se il dispositivo non può rappresentare il valore di colore specificato, il colore viene impostato sul colore fisico più vicino.

Sintassi

COLORREF SetDCBrushColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

Parametri

[in] hdc

Handle per il controller di dominio.

[in] color

Nuovo colore del pennello.

Valore restituito

Se la funzione ha esito positivo, il valore restituito specifica il colore del pennello DC precedente come valore COLORREF .

Se la funzione ha esito negativo, il valore restituito è CLR_INVALID.

Commenti

Quando il DC_BRUSH azionario viene selezionato in un controller di dominio, tutti i disegni successivi verranno eseguiti utilizzando il colore del pennello DC fino a quando il pennello di magazzino non viene deselezionato. Il colore DC_BRUSH predefinito è BIANCO.

La funzione restituisce il colore DC_BRUSH precedente, anche se il pennello di magazzino DC_BRUSH non è selezionato nel controller di dominio: tuttavia, questa operazione non verrà utilizzata nelle operazioni di disegno fino a quando non viene selezionata la DC_BRUSH di magazzino nel controller di dominio.

La funzione GetStockObject con un argomento di DC_BRUSH o DC_PEN può essere usata in modo intercambiabile con le funzioni SetDCPenColor e SetDCBrushColor .

ICM: La gestione dei colori viene eseguita se ICM è abilitato.

Esempio

Per un esempio di impostazione dei colori, vedere Impostazione del colore della penna o del pennello.

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 wingdi.h (include Windows.h)
Libreria Gdi32.lib
DLL Gdi32.dll

Vedi anche

COLORREF

Funzioni del contesto di dispositivo

Panoramica dei contesti di dispositivo

GetDCBrushColor