L_INT LBitmapList::GetNextItem(pLBitmap)
Gets the next item of the bitmap list object.
Pointer to an allocated bitmap object that will receive the next item of a bitmap list.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
This function will retrieve the bitmap list item that succeeds the item at the current index, and increment the current index if successful. If there is no next item (the current index = the last item in the list) this function fills pLBitmap with the last item.
You can get the current index by calling LBitmapList::GetCurrentIndex.
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.
Win32, x64.
For an example, refer to LBitmapList::GetFirstItem.
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document