CDC::SetPixelV

Sets the pixel at the specified coordinates to the closest approximation of the specified color.

BOOL SetPixelV(
   int x,
   int y,
   COLORREF crColor
);
BOOL SetPixelV(
   POINT point,
   COLORREF crColor 
);

Parameters

  • x
    Specifies the x-coordinate, in logical units, of the point to be set.

  • y
    Specifies the y-coordinate, in logical units, of the point to be set.

  • crColor
    Specifies the color to be used to paint the point.

  • point
    Specifies the logical x- and y-coordinates of the point to be set. You can pass either a POINT data structure or a CPoint object for this parameter.

Return Value

Nonzero if the function is successful; otherwise 0.

Remarks

The point must be in both the clipping region and the visible part of the device surface. Not all devices support the member function. For more information, see the RC_BITBLT capability in the CDC::GetDeviceCaps member function. SetPixelV is faster than SetPixel because it does not need to return the color value of the point actually painted.

Requirements

Header: afxwin.h

See Also

Reference

CDC Class

Hierarchy Chart

CDC::GetDeviceCaps

CDC::SetPixel

SetPixelV

Other Resources

CDC Members