LImageListControl::ImportBitmapList

#include "ltwrappr.h"

L_INT LImageListControl::ImportBitmapList(pImportList)

/* pointer to structure */

Inserts a list of bitmaps into the ImageList Control.

Parameter	Description
pImportList	Pointer to the LILIMPORTBITMAPLIST structure that contains the list of bitmaps to be inserted.

Returns

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

Comments

You must set the uStructSize member of the LILIMPORTBITMAPLIST structure before using this function.

The list of bitmaps found in the passed LILIMPORTBITMAPLIST structure will be inserted into the Image List control starting from nStartIndex to (nStartIndex + nItemsToInsert –1).

After inserting the list of bitmaps successfully into the ImageList control, don’t try to free the bitmaps of the passed list (hList’s bitmaps). The ImageList control will have a reference to hList bitmaps-- not a copy of them.

Required DLLs and Libraries

LTDISLTFILLTIMG

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:	LImageListControl::ExportBitmapList, LImageListControl::GetItemOptions, LImageListControl::SetItemOptions
Topics:	Using the ImageList Control
	Raster Image Functions: Displaying Images

Example

L_VOID TestImportList(HWND hWnd, LBitmapList& BitmapList, LImageListControl& ImgList)
{
   L_INT nRet ;
   if(IsWindow(hWnd) && BitmapList.GetHandle())
   {
      LILIMPORTBITMAPLIST ImportList;
      HWND handle = ImgList.CreateControl(hWnd, 0) ;

      // Getting the number of bitmaps in the list.

      if(BitmapList.GetItemsCount() > 0) // There are some bitmaps
      {
         ZeroMemory(&ImportList, sizeof(LILIMPORTBITMAPLIST));
         ImportList.uStructSize = sizeof(LILIMPORTBITMAPLIST);
         ImportList.hList = BitmapList.GetHandle() ;
         ImportList.nStartIndex = 0; // Start from Index 0.
         ImportList.nItemsToInsert = BitmapList.GetItemsCount();// Import all the list bitmaps.
         ImportList.pText = _T("Imported Bitmap-Text");
         ImportList.pTextExt = _T("Imported Bitmap-TextExt");

         nRet = ImgList.ImportBitmapList(&ImportList);
         /* update the control */
         RedrawWindow(hWnd, NULL, NULL, RDW_INVALIDATE | RDW_UPDATENOW | RDW_ERASE);
      }
   }
}