Función GetPixel (wingdi.h)

  • Artículo

La función GetPixel recupera el valor de color rojo, verde, azul (RGB) del píxel en las coordenadas especificadas.

Sintaxis

COLORREF GetPixel(
  [in] HDC hdc,
  [in] int x,
  [in] int y
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] x

Coordenada x, en unidades lógicas, del píxel que se va a examinar.

[in] y

Coordenada y, en unidades lógicas, del píxel que se va a examinar.

Valor devuelto

El valor devuelto es el valor COLORREF que especifica el RGB del píxel. Si el píxel está fuera de la región de recorte actual, el valor devuelto es CLR_INVALID (0xFFFFFFFF definido en Wingdi.h).

Comentarios

El píxel debe estar dentro de los límites de la región de recorte actual.

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

Se debe seleccionar un mapa de bits en el contexto del dispositivo; de lo contrario, se devuelve CLR_INVALID en todos los píxeles.

Requisitos

   
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

SetPixel