SelectPalette (Windows CE 5.0)

Windows CE 5.0
Send Feedback

This function selects the specified logical palette into a device context.

HPALETTE SelectPalette( 
  HDC hdc, 
  HPALETTE hpal, 
  BOOL bForceBackground


[in] Handle to the device context (DC).
[in] Handle to the logical palette to be selected.
[in] Ignored.

Because Windows CE does not arbitrate between the palettes of the foreground and background applications, Windows CE ignores this parameter and always treats it as FALSE. This causes the logical palette to be copied into the device palette when the application is in the foreground.

Return Values

A handle that identifies the device context's previous logical palette indicates success.

NULL 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.

An application can select a logical palette into more than one device context. However, changes to a logical palette will affect all device contexts for which it is selected.


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

See Also

CreatePalette | GetDeviceCaps | RealizePalette | GDI Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.