CDC::GetPixel

Retrieves the RGB color value of the pixel at the point specified by x and y.

COLORREF GetPixel( 
   int x, 
   int y  
) const; 
COLORREF GetPixel( 
   POINT point  
) const;

Parameters

  • x
    Specifies the logical x-coordinate of the point to be examined.

  • y
    Specifies the logical y-coordinate of the point to be examined.

  • point
    Specifies the logical x- and y-coordinates of the point to be examined.

Return Value

For either version of the function, an RGB color value for the color of the given point. It is –1 if the coordinates do not specify a point in the clipping region.

Remarks

The point must be in the clipping region. If the point is not in the clipping region, the function has no effect and returns –1.

Not all devices support the GetPixel function. For more information, see the RC_BITBLT raster capability under the GetDeviceCaps member function.

The GetPixel member function has two forms. The first takes two coordinate values; the second takes either a POINT structure or a CPoint object.

Requirements

Header: afxwin.h

See Also

Reference

CDC Class

Hierarchy Chart

CDC::GetDeviceCaps

CDC::SetPixel

GetPixel

POINT Structure

CPoint Class