GetPixel function (wingdi.h)

The GetPixel function retrieves the red, green, blue (RGB) color value of the pixel at the specified coordinates.

Syntax

COLORREF GetPixel(
  [in] HDC hdc,
  [in] int x,
  [in] int y
);

Parameters

[in] hdc

A handle to the device context.

[in] x

The x-coordinate, in logical units, of the pixel to be examined.

[in] y

The y-coordinate, in logical units, of the pixel to be examined.

Return value

The return value is the COLORREF value that specifies the RGB of the pixel. If the pixel is outside of the current clipping region, the return value is CLR_INVALID (0xFFFFFFFF defined in Wingdi.h).

Remarks

The pixel must be within the boundaries of the current clipping region.

Not all devices support GetPixel. An application should call GetDeviceCaps to determine whether a specified device supports this function.

A bitmap must be selected within the device context, otherwise, CLR_INVALID is returned on all pixels.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

See also

Bitmap Functions

Bitmaps Overview

COLORREF

GetDeviceCaps

SetPixel