Partilhar via


CDC::SetPixel

Define o pixel no ponto especificado para a aproximação mais próxima da cor especificada pelo crColor.

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

Parâmetros

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

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

  • crColor
    Um COLORREF RGB valor Especifica a cor usada para pintar o ponto.Consulte COLORREF in the Windows SDK para obter uma descrição desse valor.

  • point
    Especifica as lógicas x e y-coordenadas do ponto a ser definida.Você pode passar uma uma estrutura de ponto ou um objeto de CPoint para este parâmetro.

Valor de retorno

Um valor RGB para a cor que o ponto, na verdade, é pintado.Esse valor pode ser diferente daquele especificado por crColor se uma aproximação dessa cor é usada.Se a função falhar (se o ponto de estiver fora da região de recorte), o valor de retorno é – 1.

Comentários

O ponto deve estar na região de corte.Se o ponto não estiver na região de corte, a função não faz nada.

Nem Tudo dispositivos oferecem suporte a função de SetPixel.Para determinar se um dispositivo oferece suporte a SetPixel, chamar a função de membro GetDeviceCaps com o índice de RASTERCAPS e Marcar o valor de retorno para o Sinalizar de RC_BITBLT.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CDC

Gráfico de hierarquia

CDC::GetDeviceCaps

CDC::GetPixel

SetPixel

Estrutura de ponto

Classe CPoint

Outros recursos

Membros do CDC