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.