This function retrieves the index for the entry in the specified logical palette that most closely matches a specified color value.
At a Glance
Header file: | Wingdi.h |
Windows CE versions: | 2.0 and later |
Syntax
UINT GetNearestPaletteIndex( HPALETTE hpal, COLORREF crColor);
Parameters
hpal
[in] Handle to a logical color palette.
crColor
[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.
Remarks
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.
See Also