L_DispContainerInsertCell
#include "ltivw.h"
L_INT EXT_FUNCTION L_DispContainerInsertCell(hCon, nCellIndex, uFlags)
HDISPCONTAINER hCon; |
/* handle to the container */ |
L_INT nCellIndex; |
/* insertion index */ |
L_UINT uFlags; |
/* reserved for future use */ |
Adds a new empty cell to the container. This function is available only in the Medical Imaging Suite toolkits.
Parameter |
Description |
hCon |
Handle to the container. |
nCellIndex |
Zero-based index that specifies where to place the new cell. Pass –1 or a number greater than the cell count to append the cell to the end of the current cell list. |
uFlags |
Reserved for future use. Must be zero. |
Returns
>= 0 |
The index of the new cell |
< 0 |
An error occurred. Refer to Return Codes. |
Comments
When the user passes –1 or a number greater than the cells count in nCellIndex, the function will append the container with the new cell. Otherwise all the cells starting from nCellIndex will be shifted to the right one block in order to add the new cell.
The newly inserted 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. |
See Also
Example
For an example, refer to L_DispContainerCreate.