LImageViewer::SetCellScale

#include "ltwrappr.h"

L_INT LImageViewer::SetCellScale (nCellIndex, nSubCellIndex, dScale, uFlags)

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. This feature is available in version 16 or higher.

Parameter

Description

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 the LImageViewer::SetCellProperties function. The other method is by using the LImageViewer::GetCellScale and LImageViewer::SetCellScale functions. 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 LImageViewer::GetCellScale function.

To set the properties of the scale action use the LImageViewer::SetActionProperties function.

To retrieve the properties of the scale action use the LImageViewer::GetActionProperties function.

To set the properties of the scale action use the LImageViewer::SetActionProperties function.

To get the properties of the scale action use the LImageViewer::GetActionProperties function.

To set the scale mode of cell or sub-cell use the LImageViewer::SetCellScaleMode function.

To get the scale mode of cell or sub-cell use the LImageViewer::GetCellScaleMode 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.

See Also

Functions:

LImageViewer::GetCellScaleMode, LImageViewer::SetCellScaleMode, LImageViewer::GetCellScale,LImageViewer::Create, LImageViewer::RemoveCell, LImageViewer::InsertCell, LImageViewer::GetCellCount, LImageViewer::GetCellWindowHandle, LImageViewer::SetCellTag, LImageViewer::SetCellProperties, LImageViewer::AddAction, LImageViewer::SetAction, LImageViewer::GetActionProperties, LImageViewer::RemoveAction, LImageViewer::GetActionCount, Class Members

Topics:

Applying Actions

 

Image Viewer Functions: Applying Actions

Example

For an example, refer to LImageViewer::BeginUpdate.