CDC::SetPixelV

Switch View :

ScriptFree

Visual Studio 2010 - Visual C++

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

Reference

CDC Class

Hierarchy Chart

CDC::GetDeviceCaps

CDC::SetPixel

SetPixelV

Other Resources

CDC Members