LBitmapList::CopyItems

#include "ltwrappr.h"

virtual L_INT LBitmapList::CopyItems(LBitmapListSrc, uIndex, uCount)

LBitmapList& LBitmapListSrc;	/* an LBitmapList object */
L_UINT uIndex;	/* index of the first bitmap to copy */
L_UINT uCount;	/* number of bitmaps to copy */

Creates a new bitmap list in the class object by copying the specified bitmaps from an existing bitmap list in the source object. Bitmap handles and image data are copied.

Parameter	Description
LBitmapListSrc	Reference to the bitmap list object from which to copy the bitmaps.
uIndex	Index of the first bitmap to copy.
uCount	Number of bitmaps to copy. You can specify (L_UINT) -1 to copy to the end of the existing list.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

If the calling object currently has a created bitmap list, this function will return an error.

The LBitmapListSrc parameter is passed by reference, and is a required parameter.

Required DLLs and Libraries

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.

Platforms

Win32, x64.

See Also

Functions:	Class Members
Topics:	Raster Image Functions: Playing Animated Images
	Implementing Animation

Example

This example copies all but the first two bitmaps in a list of bitmaps;

then calls another function to save the copied list.

L_INT LBitmapList__CopyItemsExample(LBitmapList *pBitmapList)
{
   L_INT nRet;
   LBitmapList NewList;
   /* Copy all but the first two bitmaps of the incoming list */
   nRet =NewList.CopyItems (*pBitmapList, 2, (L_UINT) -1);
   if(nRet !=SUCCESS)
      return nRet;
   // the list (pBitmapList) is copied in the NewList
   //...
   return SUCCESS;
}