L_ILM_IMPORTBITMAPLIST

Show in webframe

Send this message to insert a list of bitmaps into the ImageList Control.

Parameter	Description
wParam	Ignored, use 0.
lParam	Pointer to the LILIMPORTBITMAPLIST structure that contains the list of bitmaps to be inserted.

Returns

SUCCESS	Function was successful.
<0	An error occurred. Refer to Error Codes.

Comments

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

The list of bitmaps found in the passed LILIMPORTBITMAPLIST structure (pointed to by lParam) 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 references the hList bitmaps, and does not have a copy of them.

The associated macro is:

L_ImgListImportBitmapList(hWnd, pImportList)

For a complete list of available macros, refer to the Ltlst.h file.

See Also

Elements:	L_ILM_EXPORTBITMAPLIST, L_ILM_GETITEMOPTIONS, L_ILM_SETITEMOPTIONS
Topics:	Using the ImageList Control
	Image List Control Messages

Example

 L_INT ILM_IMPORTBITMAPLISTExample(HWND hCtrl, HBITMAPLIST hList) 
{
   if(IsWindow(hCtrl) && hList) 
   {
      L_UINT uCount =0; 

      // Getting the number of bitmaps in the list. 
      L_GetBitmapListCount(hList, &uCount); 

      if(uCount > 0) // There are some bitmaps
      {
         LILIMPORTBITMAPLIST ImportList; 
         ZeroMemory(&ImportList, sizeof(LILIMPORTBITMAPLIST)); 

         ImportList.uStructSize     = sizeof(LILIMPORTBITMAPLIST); 
         ImportList.hList           = hList; 
         ImportList.nStartIndex     = 0;    // Start from Index 0. 
         ImportList.nItemsToInsert  = uCount;// Import all the list bitmaps. 
         ImportList.pText           = _T("Imported Bitmap-Text");
         ImportList.pTextExt        = _T("Imported Bitmap-TextExt");

         L_INT nRet = (L_INT)SendMessage(hCtrl, L_ILM_IMPORTBITMAPLIST, (WPARAM)0, (LPARAM)(&ImportList)); 
         /* update the control */
         RedrawWindow(hCtrl, NULL, NULL, RDW_INVALIDATE | RDW_UPDATENOW | RDW_ERASE); 
         return nRet;
      }
   }

   return ERROR_INVALID_PARAMETER;
}