In This Topic ▼

L_DispContainerCreateCell

Summary

Creates a cell, which is a window that will contain the image. Each cell can hold a single image or a list of images.

Syntax

#include "ltivw.h"

L_LTIVW_API L_HWND L_DispContainerCreateCell(hWndParent, uFlags);

Parameters

L_HWND hWndParent

Handle to the parent or owner window of the container window being created.

L_UINT uFlags

Reserved for future. Must be 0.

Returns

Value	Meaning
>0	A handle to the cell window.
NULL	An error occurred. To get extended error information, call GetLastError and Refer to Return Codes.

Comments

The newly created cell will be empty. To add a bitmap list to it, use the function L_DispContainerSetCellBitmapList.

Required DLLs and Libraries

LTIVW
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Example

This function creates a new cell.

L_INT L_DispContainerCreateCellExample(HDISPCONTAINER hCon, 
                                                      HBITMAPLIST  * hBitmapList, 
                                                      L_INT          nCellIndex) 
{ 
   L_INT nRet; 
   L_INT nCount = L_DispContainerGetCellCount (hCon, 0);  
 
   // Check the validity of the cell index 
   if ((nCellIndex < 0) || (nCellIndex >= nCount))  
      return 0;  
 
   HWND hParent = L_DispContainerGetWindowHandle(hCon, 0); 
 
 
   HWND hCellWnd = L_DispContainerCreateCell(hParent, 0); 
 
   // retrieve the bitmap list.  
   nRet = L_DispContainerGetCellBitmapList(hCellWnd, hBitmapList, 0);  
   if(nRet != SUCCESS) 
      return nRet; 
 
   nRet = L_DispContainerInsertCell(hCon, hCellWnd, 0, 0); 
   if(nRet != SUCCESS) 
      return nRet; 
 
   return SUCCESS; 
}