LImageViewerCell::GetCellRegionHandle

Summary

Retrieves a copy of the region handle for the specified bitmap in the specified cell.

Syntax

L_INT LImageViewerCell::GetCellRegionHandle(nSubCellIndex, phRgn, uFlags)

Parameters

L_INT nSubCellIndex

A zero-based index into the image list attached to the cell. This sub-cell contains the image that contains the bitmap region that needs to be retrieved. Pass -2 to refer to the selected sub-cell.

L_HRGN * phRgn

Pointer to the Windows region handle. You do not have to create the region. You just declare the HRGN variable and pass its address.

L_UINT uFlags

Reserved for future use. Pass 0.

Returns

Comments

You should delete the region handle once it is no longer needed using the windows function DeleteObject.

This function gets the cell region handle. To set the bitmap region handle, use the LImageViewerCell::SetCellRegionHandle 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::Create
• LImageViewer::RemoveCell
• LImageViewer::InsertCell
• LImageViewer::GetCellCount
• LImageViewer::GetWindowHandle
• LImageViewerCell::SetCellBitmapList
• LImageViewerCell::SetCellTag
• LImageViewerCell::GetCellProperties
• LImageViewer::GetCellPosition
• LImageViewer::RepositionCell
• LImageViewerCell::GetCellBitmapList
• LImageViewer::GetCellBounds
• LImageViewerCell::FreezeCell
• LImageViewerCell::SelectCell
• LImageViewerCell::IsCellSelected
• LImageViewerCell::IsCellFrozen
• Class Members

Topics

• Image Viewer Cells
• Window Control/Image Viewer Functions: Image Viewer Cells

Example

For an example, refer to LImageViewerCell::RegionCallBack.