Compartir a través de


Función SetPixelV (wingdi.h)

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

Consulte también

Funciones de mapa de bits

Información general sobre mapas de bits

COLORREF

GetDeviceCaps

RGB

SetPixel