Função GetPixel (wingdi.h)

Artigo
08/27/2023

A função GetPixel recupera o valor de cor vermelho, verde, azul (RGB) do pixel nas coordenadas especificadas.

Sintaxe

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

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] x

A coordenada x, em unidades lógicas, do pixel a ser examinado.

[in] y

A coordenada y, em unidades lógicas, do pixel a ser examinado.

Valor retornado

O valor retornado é o valor COLORREF que especifica o RGB do pixel. Se o pixel estiver fora da região de recorte atual, o valor retornado será CLR_INVALID (0xFFFFFFFF definido em Wingdi.h).

Comentários

O pixel deve estar dentro dos limites da região de recorte atual.

Nem todos os dispositivos dão suporte a GetPixel. Um aplicativo deve chamar GetDeviceCaps para determinar se um dispositivo especificado dá suporte a essa função.

Um bitmap deve ser selecionado dentro do contexto do dispositivo, caso contrário, CLR_INVALID é retornado em todos os pixels.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll