In This Topic ▼

LImageListControl::ImportBitmapList

Summary

Inserts a list of bitmaps into the ImageList Control.

Syntax

#include "ltwrappr.h"

L_INT LImageListControl::ImportBitmapList(pImportList)

Parameters

pLILIMPORTBITMAPLIST pImportList

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

Returns

Value	Meaning
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, do not try to free the bitmaps of the passed list (hLists bitmaps). The ImageList control will have a reference to hList bitmaps-- not a copy of them.

Required DLLs and Libraries

LTDIS
LTFIL
LTIMG
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.

Example

L_INT LImageListControl__ImportBitmapListExample(HWND hWnd, LBitmapList& BitmapList, LImageListControl& ImgList)  
{ 
   L_INT nRet ; 
 
   if(IsWindow(hWnd) && BitmapList.GetHandle())  
   { 
      LILIMPORTBITMAPLIST ImportList;  
 
      // 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); 
         if(nRet != SUCCESS) 
            return nRet; 
 
         /* update the control */ 
         RedrawWindow(hWnd, NULL, NULL, RDW_INVALIDATE | RDW_UPDATENOW | RDW_ERASE);  
      } 
   } 
   return SUCCESS; 
}