L_DispContainerInsertCell

#include "ltivw.h"

L_LTIVW_API L_INT 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.

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. Pass 0.

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

Functions:	L_DispContainerCreate, L_DispContainerRemoveCell, L_DispContainerGetCellCount, 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

For an example, refer to L_DispContainerCreate.