GetNearestColor

This function returns the system palette color that will be displayed when the specified color value is used.

COLORREF GetNearestColor(
  HDC hdc, 
  COLORREF crColor
); 

Parameters

  • hdc
    [in] Handle to the device context (DC).
  • crColor
    [in] 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 specified color value.

If the function fails, the return value is CLR_INVALID.

To get extended error information, call GetLastError.

Remarks

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

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Windows.h.
Link Library: Coredll.lib.

See Also

GetDeviceCaps | COLORREF | GDI Functions

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.