L_DispContainerSetCellScaleMode

#include "l_bitmap.h"

L_LTIVW_API L_INT EXT_FUNCTION L_DispContainerSetCellScaleMode(hCellWnd, nSubCellIndex,, uScaleMode,uFlags)

HWND hCellWnd;

/* handle to the cell window */

L_INT nSubCellIndex;

/* index into the image list attached to the cell */

L_UINT uScaleMode;

/* flag */

L_UINT uFlags;

/* reserved for future use */

Sets the current scale mode for the specified cell or sub-cell.

Parameter

Description

hCellWnd

A handle to the window that represents the cell on which the function's effect will be applied.

nSubCellIndex

A zero-based index into the image list attached to the cell specified in nCellIndex. The sub-cell with nSubCellIndex, will have its scale mode set. Pass -2 to set the scale mode of the selected sub-cell.

uScaleMode

Flag that indicates the type of the scale. Possible values are:

 

Value

Meaning

 

CONTAINER_SCALEMODE_NORMAL

[0x00000000] no scale mode applied. This is the defualt value.

 

CONTAINER_SCALEMODE_FIT

[0x00000001] The image will fit to the sub-cell boundaries.

 

CONTAINER_SCALEMODE_FITWIDTH

[0x00000002] The image width will fit to the sub-cell boundaires.

 

CONTAINER_SCALEMODE_FITHEIGHT

[0x00000003] The image height will fit to the image boundareis.

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.

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_DispContainerSetCellScaleMode, L_DispContainerGetCellScale, L_DispContainerSetCellScale, 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.