Gdi::SelectPalette_I (Windows Embedded CE 6.0)

1/6/2010

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

Syntax

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 Embedded CE does not arbitrate between the palettes of the foreground and background applications, Windows Embedded 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 Value

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

See Also

Reference

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