Função SetPixelV (wingdi.h)

Artigo
03/13/2024

A função SetPixelV define o pixel nas coordenadas especificadas para a aproximação mais próxima da cor especificada. O ponto deve estar na região de recorte e na parte visível da superfície do dispositivo.

Sintaxe

BOOL SetPixelV(
  [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 .

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

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

Comentários

Nem todos os dispositivos dão suporte à função SetPixelV . Para obter mais informações, consulte a descrição da funcionalidade RC_BITBLT na função GetDeviceCaps .

SetPixelV é mais rápido que SetPixel porque não precisa retornar o valor de cor do ponto realmente pintado.

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