GetNearestColor

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

At a Glance

Header file: Wingdi.h
Windows CE versions: 1.0 and later

Syntax

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.

See Also

COLORREF, GetDeviceCaps