Compartir a través de


Función SetPixel (wingdi.h)

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

Consulte también

Funciones de mapa de bits

Información general sobre mapas de bits

COLORREF

GetDeviceCaps

GetPixel

RGB

SetPixelV