Função SetPixel (wingdi.h)

Artigo
03/04/2024

A função SetPixel define o pixel nas coordenadas especificadas para a cor especificada.

Sintaxe

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

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] x

A coordenada x, em unidades lógicas, do ponto a ser definido.

[in] y

A coordenada y, em unidades lógicas, do ponto a ser definido.

[in] color

A cor a ser usada para pintar o ponto. Para criar um valor de cor COLORREF , use a macro RGB .

Retornar valor

Se a função for bem-sucedida, o valor retornado será o valor RGB para o qual a função define o pixel. Esse valor pode ser diferente da cor especificada por crColor; que ocorre quando uma correspondência exata para a cor especificada não pode ser encontrada.

Se a função falhar, o valor retornado será -1.

Esse pode ser o valor a seguir.

Código de retorno	Descrição
ERROR_INVALID_PARAMETER	Um ou mais dos parâmetros de entrada são inválidos.

Comentários

A função falhará se as coordenadas de pixel estiverem fora da região de recorte atual.

Nem todos os dispositivos dão suporte à função SetPixel . Para obter mais informações, consulte GetDeviceCaps.

Requisitos

Requisito	Valor
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