wingdi.h


SetPixel

La función SetPixel activa un pixel en las coordenadas especificadas y con el color especificado.

Sintaxis

COLORREF SetPixel(
    HDC hdc,          // manipulador a contexto de dispositivo 
    int X,            // coordenada x del pixel
    int Y,            // coordenada x del pixel
    COLORREF crColor  // color del pixel
   );

Parámetros:

hdc: identifica el contexto de dispositivo.

X: especifica la coordenada x, en unidades lógicas, del punto a activar.

Y: especifica la coordenada y, en unidades lógicas, del punto a activar.

crColor: especifica el color a usar para pintar el punto.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el valor RGB que la función usó para pintar el pixel. Este valor puede ser diferente del color especificado por crColor; esto sucede cuando no es posible encontrar el color exacto.

Si la función falla, el valor de retorno es -1. Para obtener más información, llamar a GetLastError.

Observaciones

La función falla si las coordenadas del pixel caen fuera de la región de clipping actual.

No todos los dispositivos soportan la función SetPixel. Para más información, consultar GetDeviceCaps.