GetNearestColor

The GetNearestColor function returns a color value identifying a color from the system palette that will be displayed when the specified color value is used.

COLORREF GetNearestColor(
  HDC hdc,           // handle of device context
  COLORREF crColor   // color to be matched
);
 

Parameters

hdc
Handle to the device context.
crColor
Specifies a color value that identifies a requested color.

Return Values

If the function succeeds, the return value identifies a color from the system palette that corresponds to the given color value.

If the function fails, the return value is CLR_INVALID.

Windows NT: To get extended error information, call GetLastError.

Windows CE: The GetNearestColor function returns the color from the selected device context that most closely matches the specified color value.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Requires version 1.0 or later.
  Header: Declared in wingdi.h.
  Import Library: Use gdi32.lib.

See Also

Colors Overview, Color Functions, GetDeviceCaps, GetNearestPaletteIndex, COLORREF