L_DispContainerGetCellCount

#include "ltivw.h"

L_LTIVW_API L_INT L_DispContainerGetCellCount(hCon, uFlags)

HDISPCONTAINER hCon;	/* handle to the container */
L_UINT uFlags;	/* reserved for future use */

Returns the number of cells managed by the container. This function is available only in the Medical Imaging Suite toolkits.

Parameter	Description
hCon	Handle to the container.
uFlags	Reserved for future use. Pass 0.

Returns

>= 0	The number of cells managed by the container.
< 0	An error occurred. Refer to Return Codes.

Comments

To add cells to the container, call L_DispContainerInsertCell. To remove one or more cells from the container, call L_DispContainerRemoveCell.

Please note that the maximum number of rows that a container can have is 4 and the maximum number of columns is 8. However, the number of cells that can be added to a container is limited only by the available memory.

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.

See Also

Functions:	L_DispContainerCreate, L_DispContainerInsertCell, L_DispContainerRemoveCell, L_DispContainerGetCellWindowHandle, L_DispContainerSetCellBitmapList, L_DispContainerSetCellTag, L_DispContainerSetCellProperties, L_DispContainerGetCellProperties, L_DispContainerGetCellPosition, L_DispContainerRepositionCell, L_DispContainerGetCellBitmapList, L_DispContainerGetCellBounds, L_DispContainerFreezeCell, L_DispContainerSelectCell, L_DispContainerIsCellSelected, L_DispContainerIsCellFrozen
Topics:	Image Viewer Cells
	Image Viewer Functions: Image Viewer Cells

Example

This procedure unfreezes any frozen cell

 L_INT DispContainerGetCellCountExample(HDISPCONTAINER hCon) 
{
   L_INT nRet;
   // Get the cells count. 
   L_INT nCount = L_DispContainerGetCellCount(hCon, 0); 
   L_INT nI; 
   for (nI = 0; nI < nCount; nI++)
   {
      // if there is a selected cell make it unselected and vice versa
      L_BOOL bFreezed = L_DispContainerIsCellFrozen(hCon, nI, 0); 
      if (bFreezed) 
      {
         nRet = L_DispContainerFreezeCell (hCon, nI, FALSE, 0); 
         if(nRet != SUCCESS)
            return nRet;
      }
   }
   return SUCCESS;
}