Share via


Gdi::SelectPalette_I (Windows CE 5.0)

Send Feedback

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

static WINGDIAPI HPALETTE WINAPI SelectPalette_I(HDChdc,HPALETTEhpal,BOOLbForceBackground);

Parameters

  • hdc
    [in] Handle to the device context.

  • 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 this value as FALSE.

    This behavior 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 previous logical palette for the device context indicates success.

NULL indicates failure.

To get extended error information, call GetLastError.

Remarks

This method is an internal version of the SelectObject function.

An application can determine whether a device supports palette operations by calling the Gdi::GetDeviceCaps_I 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 affect all device contexts for which the palette is selected.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Gdi.hpp.

See Also

Gdi | SelectObject | Gdi::CreatePalette_I | Gdi::GetDeviceCaps_I | Gdi::RealizePalette_I

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.