Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

GetNearestPaletteIndex (Windows CE 5.0)

Windows CE 5.0
Send Feedback

This function retrieves the index for the entry in the specified logical palette that most closely matches a specified color value.

UINT GetNearestPaletteIndex( 
  HPALETTE hpal, 
  COLORREF crColor


[in] Handle to a logical color palette.
[in] Specifies a color to be matched.

Return Values

The index of an entry in a logical palette indicates success.

CLR_INVALID indicates failure.

To get extended error information, call GetLastError.


An application can determine whether a device supports palette operations by calling the GetDeviceCaps function and specifying the RASTERCAPS constant.

If the given logical palette contains entries with the PC_EXPLICIT flag set, the return value is undefined.


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

See Also

GetDeviceCaps | GetPaletteEntries | GetSystemPaletteEntries | GDI Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.

© 2015 Microsoft