Funzione SetDCPenColor (wingdi.h)

Articolo
03/04/2024

La funzione SetDCPenColor imposta il colore corrente della penna 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 SetDCPenColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

Parametri

[in] hdc

Handle per il controller di dominio.

[in] color

Nuovo colore della penna.

Valore restituito

Se la funzione ha esito positivo, il valore restituito specifica il colore della penna DC precedente come valore COLORREF . Se la funzione ha esito negativo, il valore restituito è CLR_INVALID.

Commenti

La funzione restituisce il colore DC_PEN precedente, anche se la penna di magazzino DC_PEN non è selezionata nel controller di dominio; tuttavia, questa operazione non verrà utilizzata nelle operazioni di disegno fino a quando non viene selezionata la DC_PEN 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