Microsoft Windows CE 3.0  

SelectPalette

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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

HPALETTE SelectPalette( HDC
hdc
,
HPALETTE
hpal
,
BOOL
bForceBackground
);

Parameters

hdc
[in] Handle to the device context (DC).
hpal
[in] Handle to the logical palette to be selected.
bForceBackground
[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.

Remarks

An application can determine whether a device supports palette operations by calling the GetDeviceCapsfunction 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.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Wingdi.h   Mgpal.lib
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CreatePalette, GetDeviceCaps, GetLastError, RealizePalette