Gdi::SelectPalette_I

  • Article

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

static WINGDIAPI HPALETTE WINAPI SelectPalette_I(
  HDC hdc, 
  HPALETTE hpal, 
  BOOL bForceBackground
);

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

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

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.