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.

See Also

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

Example

For an example, refer to LImageViewer::Create.