L_DispContainerSetCellScale

#include "l_bitmap.h"

L_LTIVW_API L_INT EXT_FUNCTION L_DispContainerSetCellScale(hCon, nCellIndex, nSubCellIndex, dScale, uFlags)

HDISPCONTAINER hCon;	/* handle to the container */
L_INT nCellIndex;	/* index of a cell */
L_INT nSubCellIndex;	/* index into the image list attached to the cell */
L_DOUBLE dScale;	/* scale value */
L_UINT uFlags;	/* reserved for future use */

Sets the current scale value of the specified cell or sub-cell.

Parameter	Description
hCon	Handle to the container.
nCellIndex	A zero-based index of the cell that contains the sub-cell, which is having its scale value set. Pass -1 to set the scale value of the specified sub-cell for all cells managed by the container. Pass -2 to set the scale value of the specified sub-cell for the selected cells managed by the container.
nSubCellIndex	A zero-based index into the image list attached to the cell specified in nCellIndex. This image will be scaled. Pass -1 to apply this effect on all sub-cells. Pass -2 to apply this effect on the selected sub-cell.
dScale	Value that represent the new scale value to be set.
uFlags	Reserved for future use. Pass 0.

Returns

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

Comments

Currently, there are two ways to fit an image to a cell. One is by setting the bIsFit value of DISPCELLPROPERTIES structure to true (also remembering to set the corresponding uMask value), and then sending this structure to L_DispContainerSetCellProperties. The other method is by using L_DispContainerGetCellScale and L_DispContainerSetCellScale. In order to be able to use these functions make sure that bIsFit is set to FALSE.

To get the scale of cell or sub-cell use the L_DispContainerGetCellScale function.
To set the properties of the scale action use the L_DispContainerSetActionProperties function.
To retrieve the properties of the scale action use the L_DispContainerGetActionProperties function.
To set the properties of the scale action use the L_DispContainerSetActionProperties function.
To get the properties of the scale action use the L_DispContainerGetActionProperties function.
To set the scale mode of cell or sub-cell use the L_DispContainerSetCellScaleMode function.
To get the scale mode of cell or sub-cell use the L_DispContainerGetCellScaleMode function.

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.

Platforms

Windows 95 / 98 / Me; Windows 2000 / XP; Windows CE.

See Also

Functions:	L_DispContainerGetCellScaleMode, L_DispContainerSetCellScaleMode, L_DispContainerGetCellScale,L_DispContainerCreate, L_DispContainerRemoveCell, L_DispContainerInsertCell, L_DispContainerGetCellCount, L_DispContainerGetCellWindowHandle, L_DispContainerSetCellTag, L_DispContainerSetCellProperties, L_DispContainerAddAction, L_DispContainerSetAction, L_DispContainerGetActionProperties, L_DispContainerRemoveAction, L_DispContainerGetActionCount
Topics:	Applying Actions
	Image Viewer Functions: Applying Actions

Example

For an example, refer to L_DispContainerBeginUpdate.