L_DispContainerFreezeCell

#include "ltivw.h"

L_LTIVW_API L_INT L_DispContainerFreezeCell(hCon, nCellIndex, bFreeze, uFlags)

HDISPCONTAINER hCon;

/* handle to the container */

L_INT nCellIndex;

/* index of the cell */

L_BOOL bFreeze;

/* flag */

L_UINT uFlags;

/* reserved for future use */

Freezes or un-freezes the specified cell.

Parameter

Description

hCon

Handle to the container.

nCellIndex

A zero-based index of the cell to freeze or un-freeze.  Pass -1 to freeze or un-freeze all cells. Pass -2 to freeze or un-freeze any selected cells.

bFreeze

Flag that indicates whether to freeze or unfreeze the specified cell. Possible values are:

 

Value

Meaning

 

TRUE

Freeze the specified cell. No further container actions can be applied to this cell while it is frozen.

 

FALSE

Un-freeze the specified cell. Actions associated with the container can be applied to the specified cell.

uFlags

Reserved for future use. Pass 0.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Freezing a cell means that no actions using the mouse or the keyboard can be performed on the cell. Some cell properties can still be changed manually however using L_DispContainerSetCellProperties, L_DispContainerSelectCell and L_DispContainerSetProperties.

For more information on actions associated with a container, refer to Applying Actions.

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_DispContainerInsertCell, L_DispContainerGetCellCount, L_DispContainerGetCellWindowHandle, L_DispContainerSetCellTag, L_DispContainerSetCellProperties, L_DispContainerGetCellProperties, L_DispContainerRepositionCell, L_DispContainerGetCellPosition, L_DispContainerSetCellBitmapList, L_DispContainerGetCellBitmapList, L_DispContainerGetCellBounds, L_DispContainerSelectCell, L_DispContainerIsCellSelected, L_DispContainerIsCellFrozen

Topics:

Image Viewer Cells

 

Image Viewer Functions: Image Viewer Cells

Example

For an example, refer to L_DispContainerGetCellCount.