Condividi tramite


Funzione SetDCPenColor (wingdi.h)

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

Vedi anche

COLORREF

Funzioni del contesto di dispositivo

Panoramica dei contesti di dispositivo

GetDCPenColor