L_DispContainerSetCellRegionHandle

Summary

Creates or updates the cell or sub-cell bitmap region by adding a region that is specified by a Windows region handle.

Syntax

L_LTIVW_API L_INT EXT_FUNCTION L_DispContainerSetCellRegionHandle(hCellWnd, nSubCellIndex, hRgn, uCombineMode, uFlags)

Parameters

L_HWND hCellWnd

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

L_INT nSubCellIndex

A zero-based index into the image list attached to the cell specified in nCellIndex. This sub-cell contains the image that contains the bitmap which will contains the region handle. Pass -2 to refer to the selected sub-cell. If the cell contains 1 frame then the nSubCellIndex should be 0.

L_HRGN hRgn

Handle to the Windows region.

L_UINT uCombineMode

The action to take regarding the existing bitmap region, if one is defined. For descriptions of the possible values, refer to Creating a Bitmap Region.

L_UINT uFlags

Reserved for future use. Pass 0.

Returns

Comments

This function sets the cell region handle. To get the bitmap region handle, use L_DispContainerGetCellRegionHandle.

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_DispContainerGetCellRegionHandle
• L_DispContainerCreate
• L_DispContainerRemoveCell
• L_DispContainerInsertCell
• L_DispContainerGetCellCount
• L_DispContainerGetWindowHandle
• L_DispContainerSetCellBitmapList
• L_DispContainerSetCellTag
• L_DispContainerGetCellProperties
• L_DispContainerGetCellPosition
• L_DispContainerRepositionCell
• L_DispContainerGetCellBitmapList
• L_DispContainerGetCellBounds
• L_DispContainerFreezeCell
• L_DispContainerSelectCell
• L_DispContainerIsCellSelected
• L_DispContainerIsCellFrozen

Topics

• Image Viewer Cells
• Image Viewer Functions: Image Viewer Cells

Example

For an example, refer to L_DispContainerGetRegionCallBack.