L_DispContainerGetCellCount (original) (raw)
Summary
Returns the number of cells managed by the container.
Syntax
#include "ltivw.h"
L_LTIVW_API L_INT L_DispContainerGetCellCount(hCon, uFlags)
Parameters
HDISPCONTAINER hCon
Handle to the container.
L_UINT uFlags
Reserved for future use. Pass 0.
Returns
| Value | Meaning |
|---|---|
| >= 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
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++)
{
L_INT nCellIndex = 0;
HWND hCellWnd = L_DispContainerGetCellWindowHandle(hCon, nCellIndex, 0);
// if there is a selected cell make it unselected and vice versa
L_BOOL bFreezed = L_DispContainerIsCellFrozen(hCellWnd, 0);
if (bFreezed)
{
nRet = L_DispContainerFreezeCell (hCellWnd, FALSE, 0);
if(nRet != SUCCESS)
return nRet;
}
}
return SUCCESS;
}