Función GetPixel (wingdi.h)

Artikulua
08/27/2023

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

Sintaxis

C++

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