Función SetPixel (wingdi.h)

Artículo
03/08/2023

La función SetPixel establece el píxel en las coordenadas especificadas en el color especificado.

Sintaxis

COLORREF SetPixel(
  [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 ejecuta correctamente, el valor devuelto es el valor RGB en el que la función establece el píxel. Este valor puede diferir del color especificado por crColor; que tiene lugar cuando no se encuentra una coincidencia exacta para el color especificado.

Si se produce un error en la función, el valor devuelto es -1.

Puede ser el siguiente valor.

Código devuelto	Descripción
ERROR_INVALID_PARAMETER	Uno o varios de los parámetros de entrada no son válidos.

Comentarios

Se produce un error en la función si las coordenadas de píxeles están fuera de la región de recorte actual.

No todos los dispositivos admiten la función SetPixel . Para obtener más información, vea GetDeviceCaps.

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