Share via


CDC::SetPixel

Establece el píxel en el punto especificado a la aproximación más parecida al color especificado por crColor.

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

Parámetros

  • x
    Especifica la coordenada x lógica de punto que se establecerá.

  • y
    Especifica la coordenada y lógica de punto que se establecerá.

  • crColor
    Un valor de COLORREF RGB que especifica el color pintar el punto.Vea COLORREF en Windows SDK para obtener una descripción de este valor.

  • point
    Especifica las coordenadas x e y lógicos de punto que se establecerá.Puede pasar una estructura de puntos o un objeto de CPoint para este parámetro.

Valor devuelto

Un valor RGB para color que el punto está pintado realmente.Este valor puede ser diferente del especificado por crColor si una aproximación de ese color se utiliza.Si la función (si el punto está fuera de la zona de recorte), el valor devuelto es – 1.

Comentarios

el punto debe estar en la zona de recorte.si el punto no está en la zona de recorte, la función no hace nada.

no todos los dispositivos admiten la función de SetPixel .Para determinar si las admita el dispositivo SetPixel, llame a la función miembro de GetDeviceCaps con el índice de RASTERCAPS y compruebe el valor devuelto para el marcador de RC_BITBLT .

Requisitos

encabezado: afxwin.h

Vea también

Referencia

Clase de la CDC

Gráfico de jerarquía

CDC::GetDeviceCaps

CDC::GetPixel

SetPixel

POINT (Estructura)

Clase de CPoint