Funzione SetPixelV (wingdi.h)

Articolo
03/04/2024

La funzione SetPixelV imposta il pixel in corrispondenza delle coordinate specificate sull'approssimazione più vicina del colore specificato. Il punto deve trovarsi nell'area di ritaglio e nella parte visibile della superficie del dispositivo.

Sintassi

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

Parametri

[in] hdc

Handle per il 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 , utilizzare la macro RGB .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

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

Commenti

Non tutti i dispositivi supportano la funzione SetPixelV . Per altre informazioni, vedere la descrizione della funzionalità di RC_BITBLT nella funzione GetDeviceCaps .

SetPixelV è più veloce di SetPixel perché non è necessario restituire il valore di colore del punto effettivamente disegnato.

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