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 da hierarquia

CDC::GetDeviceCaps

CDC::GetPixel

SetPixel

Estrutura POINT

Classe CPoint