LImageViewer::InsertCell

#include "ltwrappr.h"

L_INT LImageViewer::InsertCell (nCellIndex, uFlags);

L_INT nCellIndex;	/* insertion index */
L_UINT uFlags;	/* reserved for future use */

Adds a new empty cell to the container.

Parameter	Description
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 LImageViewer::SetCellBitmapList.

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:	LImageViewer::Create, LImageViewer::RemoveCell, LImageViewer::GetCellCount, LImageViewer::GetCellWindowHandle, LImageViewer::SetCellBitmapList, LImageViewer::SetCellTag, LImageViewer::SetCellProperties, LImageViewer::GetCellProperties, LImageViewer::GetCellPosition, LImageViewer::RepositionCell, LImageViewer::GetCellBitmapList, LImageViewer::GetCellBounds, LImageViewer::FreezeCell, LImageViewer::SelectCell, LImageViewer::IsCellSelected, LImageViewer::IsCellFrozen, Class Members
Topics:	Image Viewer Cells
	Window Control/Image Viewer Functions: Image Viewer Cells

Example

For an example, refer to LImageViewer::Create.