Función SetPixelV (wingdi.h)

Artículo
03/09/2024

La función SetPixelV establece el píxel en las coordenadas especificadas en la aproximación más cercana del color especificado. El punto debe estar en la región de recorte y la parte visible de la superficie del dispositivo.

Sintaxis

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

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] x

Coordenada x, en unidades lógicas, del punto que se va a establecer.

[in] y

Coordenada y, en unidades lógicas, del punto que se va a establecer.

[in] color

Color que se va a usar para pintar el punto. Para crear un valor de color COLORREF , use la macro RGB .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

No todos los dispositivos admiten la función SetPixelV . Para obtener más información, vea la descripción de la funcionalidad RC_BITBLT en la función GetDeviceCaps .

SetPixelV es más rápido que SetPixel porque no es necesario devolver el valor de color del punto realmente pintado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll