Funzione SetDCBrushColor (wingdi.h)

Articolo
03/13/2024

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