Funzione SetPixel (wingdi.h)

Articolo
03/13/2024

La funzione SetPixel imposta il pixel alle coordinate specificate sul colore specificato.

Sintassi

COLORREF SetPixel(
  [in] HDC      hdc,
  [in] int      x,
  [in] int      y,
  [in] COLORREF color
);

Parametri

[in] hdc

Handle nel contesto del dispositivo.

[in] x

Coordinata x, in unità logiche, del punto da impostare.

[in] y

Coordinata y, in unità logiche, del punto da impostare.

[in] color

Colore da utilizzare per disegnare il punto. Per creare un valore di colore COLORREF , usare la macro RGB .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è il valore RGB che la funzione imposta il pixel su. Questo valore può essere diverso dal colore specificato da crColor; che si verifica quando non è possibile trovare una corrispondenza esatta per il colore specificato.

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

Questo può essere il valore seguente.

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Uno o più parametri di input non sono validi.

Commenti

La funzione ha esito negativo se le coordinate pixel si trovano all'esterno dell'area di ritaglio corrente.

Non tutti i dispositivi supportano la funzione SetPixel . Per altre informazioni, vedere GetDeviceCaps.

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