LBitmapList::GetLastItem

#include "ltwrappr.h"

L_INT LBitmapList::GetLastItem(pLBitmap)

LBitmapBase * pLBitmap;

/* pointer to an LBitmapBase object */

Gets the last item of the bitmap list object.

Parameter

Description

pLBitmap

Pointer to an allocated bitmap object that will receive the last item of the bitmap list.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

This function updates the current index to the last item in the list.

The bitmap handle that this function gets and attaches to the passed LBitmapBase object is a copy of the bitmap handle stored internally in the list. If you modify the bitmap, you can update the class object's internal bitmap handle to reflect the changes by using the LBitmapList::SetItem function.

You should not free the bitmap. Instead, use LBitmapList::DeleteItems.

You cannot use this function to update a bitmap list while it is being used in an animation playback.

In order to use this function, you must first allocate an LBitmapBase object (or an object derived from LBitmapBase). Pass the address of the LBitmapBase object, and it will be filled with the item from the bitmap list.

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.

See Also

Functions:

Class Members

Topics:

Raster Image Functions: Playing Animated Images

 

Implementing Animation

Example

For an example, refer to LBitmapList::GetFirstItem.