LBitmapBase::DupPalette

#include "ltwrappr.h"

virtual HPALETTE LBitmapBase::DupPalette(hPalette=0)

HPALETTE hPalette;

/* handle of the palette to be duplicated */

Retrieves a copy of either the specified HPALETTE, or the bitmap's palette.

Parameter	Description
hPalette	Handle of the palette to be duplicated. If you want to get a copy of the bitmap's palette, pass NULL.

Returns

The duplicated palette handle. If you pass NULL for hPalette, and the bitmap does not have a palette, then the return value is NULL.

Comments

Use this function to retrieve a copy of either the specified HPALETTE, or the bitmap's palette. This function makes a copy of the specified palette, so you must delete it (using DeleteObject) when you are finished with it.

Required DLLs and Libraries

LTDIS
LTFIL

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:	LBitmapBase::SetPalette, LBitmapBase::GetPalette, LBitmapBase::CreatePaintPalette, LBitmapBase::GetFixedPalette, Class Members
Topics:	Raster Image Functions: Displaying Images
	Handling Palette Changes

Example

For an example, refer to LBitmapBase::SetPalette.