wingdi.h


GetPixel

La función GetPixel recupera el valor de color rojo, verde y azul del pixel cuyas coordenadas se especifican.

Sintaxis

COLORREF GetPixel(
    HDC hdc,   // manipulador de contexto de dispositivo  
    int nXPos, // coordenada x del pixel
    int nYPos  // coordenada y del pixel
   );

Parámetros:

hdc: identifica el contexto de dispositivo.

nXPos: especifica la coordenada x, en unidades lógicas, del punto a examinar.

nYPos: especifica la coordenada y, en unidades lógicas, del punto a examinar.

Valor de retorno

Si la función tiene éxito, el valor de retorno es un valor RGB. Si el pixel está fuera de la región de clip actual, el valor de retorno es CLR_INVALID.

Observaciones

El pixel debe estar dentro de los límites actuales de la región de clip.

No todos los dispositivos soportan la función GetPixel. Una aplicación debe llamar a la función GetDeviceCaps para determinar si un dispositivo especificado soporta esta función.