LImageViewer::RemoveCell

#include "ltwrappr.h"

L_INT LImageViewer::RemoveCell (nCellIndex, bCleanImages,uFlags);

L_INT nCellIndex;	/* index of the cell to be removed */
L_BOOL bCleanImages;	/* flag */
L_UINT uFlags;	/* reserved for future use */

Removes a cell from the container.

Parameter	Description
nCellIndex	The zero-based index of the cell to be removed. Pass 1 to remove all cells. Removing the cell will not remove the attached image. The value in the bCleanImages parameter determines whether the image(s) associated with the removed cell are also freed. Pass -1 to remove all cells. Pass -2 to remove the selected cells.
bCleanImages	Flag that indicates whether to free the image(s) attached to the cell. Possible values are:
	Value	Meaning
	TRUE	Free any images attached to the cell specified in the nCellIndex parameter.
	FALSE	Do not free any images attached to the cell specified in the nCellIndex parameter. If the images are not removed, they will take up memory until the application ends.
uFlags	Reserved for future use. Pass 0.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

When a cell is removed from the image viewer, any cells to the right or below the removed cell will be automatically shifted to the left, or up, to the end of the preceding row, as needed.

To insert a new cell, call LImageViewer::InsertCell.

When the container itself is no longer needed,call the LImageViewer::Destroy function to destroy any cells within the container, any associated bitmaps, and any internal data.

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.

Functions:	LImageViewer::Create, LImageViewer::InsertCell, 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, LImageViewer::Destroy, Class Members
Topics:	Image Viewer Cells
	Window Control/Image Viewer Functions: Image Viewer Cells