Partilhar via


CDC::SetPixel

Define o pixel no ponto especificado para mais próxima aproximação de cor especificada por crColor.

COLORREF SetPixel(
   int x,
   int y,
   COLORREF crColor 
);
COLORREF SetPixel(
   POINT point,
   COLORREF crColor 
);

Parâmetros

  • x
    Especifica a coordenada x do ponto lógica a ser definido.

  • s
    Especifica a coordenada y do ponto lógica a ser definido.

  • crColor
    Um valor de COLORREF RGB especifica que a cor usado para pintar o ponto.Consulte COLORREF em Windows SDK para obter uma descrição de este valor.

  • point
    Especifica as coordenadas x e y do ponto lógicos a ser definido.Você pode passar uma estrutura de POINT ou um objeto de CPoint para esse parâmetro.

Valor de retorno

Um valor de cor RGB para que o ponto está realmente pintado.Esse valor pode ser diferente de aquele especificado por crColor se uma aproximação da cor é usada.Se a função falha (se o ponto está fora da região recortada), o valor de retorno é – 1.

Comentários

O ponto deve estar na região de corte.Se o ponto não está na região de corte, a função não fará nada.

Nem todos os dispositivos oferecem suporte a função de SetPixel .Para determinar se um dispositivo suporta SetPixel, chame a função de membro de GetDeviceCaps com o índice de RASTERCAPS e verificar o valor de retorno para o sinalizador de RC_BITBLT .

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CDC Class

Gráfico de hierarquia

CDC::GetDeviceCaps

CDC::GetPixel

SetPixel

Estrutura do ponto

Classe de CPoint