LImageViewerCell::GetBitmapHandle

#include "ltwrappr.h"

L_INT LImageViewerCell::GetBitmapHandle(nSubCellIndex, pBitmap, uFlags)

L_INT nSubCellIndex;

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

pBITMAPHANDLE pBitmap;

/* pointer to a bitmap handle */

L_UINT uFlags;

/* reserved for future use */

Retrieves the bitmap handle (or frame) of the specific cell or sub-cell.

Parameter

Description

nSubCellIndex

A zero-based index into the image list attached to the cell. The bitmap handle of the image attached to the sub-cell at this index will be retrieved. Pass -2 to retrieve the bitmap handle of the active sub-cell.

pBitmap

Pointer to the variable to be updated with the specific frame as a bitmap handle.

uFlags

Reserved for future use. Pass 0.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

This function gives the user a bitmap handle to allow him to modify the attached bitmap using any function in the LEADTOOLS toolkit.

The user must set the bitmap handle be calling LImageViewerCell::SetBitmapHandle function after he is done with it. Otherwise the viewer could view unexpected results.

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::GetCellWindowHandle, LImageViewerCell::SetCellTag, LImageViewerCell::SetCellProperties, LImageViewerCell::GetCellProperties, LImageViewer::GetCellPosition, LImageViewer::RepositionCell, LImageViewerCell::SetCellBitmapList, LImageViewerCell::GetCellBitmapList, LImageViewer::GetCellBounds, LImageViewerCell::FreezeCell, LImageViewerCell::SelectCell, LImageViewerCell::IsCellSelected, LImageViewerCell::IsCellFrozen, LImageViewerCell::SetBitmapHandle

Topics:

Window Control/Image Viewer Functions: Image Viewer Cells

 

Image Viewer Cells

Example

For an example, refer to LImageViewerCell::AnnToRgn.