L_DispContainerRemoveBitmapRegion

#include "l_bitmap.h"

L_LTIVW_API L_INT EXT_FUNCTION L_DispContainerRemoveBitmapRegion(hCon, nCellIndex, nSubCellIndex, uFlags)

HDISPCONTAINER hCon;	/* handle to the container */
L_INT nCellIndex;	/* index of a cell */
L_INT nSubCellIndex;	/* index into the image list attached to the cell */
L_UINT uFlags;	/* reserved for future use */

Removes the bitmap region from the image located at the specified cell or sub-cell.

Parameter	Description
hCon	Handle to the container.
nCellIndex	A zero-based index of the cell that contains the sub-cell, which is having its bitmap region removed. Pass -1 to remove the bitmap region from all cells with the specified nSubCellIndex. Pass -2 to remove the bitmap region from all selected cells with the specified nSubCellIndex.
nSubCellIndex	A zero-based index into the image list attached to the cell specified in nCellIndex. This image contains the region that will be removed. Pass -1 to remove the region from all the bitmaps in the cell. Pass -2 to remove the region from the bitmap in the selected sub-cell.
uFlags	Reserved for future use. Pass 0.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

You can create a region either by using one of the LEAD functions. Or you can use the tools in the image viewer that draws different shapes of regions, which are:

Nudge tools region.
Rectangle region.
Elliptical region.
Circurlare region.
Square region.
Polygon region.
Free hand region.
[18] Magic wand (contiguous color) region
Color range region.

Tools for drawing regions can be added to the viewer by calling L_DispContainerAddAction, and can be set by calling L_DispContainerSetAction.

For more information about how to create a region using the medical viewer tools. Refer to Creating a Bitmap Region Inside the Image Viewer.

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 2000 /XP/Vista.

See Also

Functions:	L_DispContainerCreate, L_DispContainerDestroy, L_DispContainerSetAction, L_DispContainerAddAction, L_DispContainerAnnToRgn.
Topics:	Working with Annotations
	Image Viewer Functions: Working with Annotations

Example

Remove bitmap regions of the first cell.

#if defined (LEADTOOLS_V16_OR_LATER)
L_INT DispContainerRemoveBitmapRegionExample(HDISPCONTAINER hCon)
{
   L_INT nRet = L_DispContainerRemoveBitmapRegion(hCon, 0, -1, 0);

   return nRet;
}
#endif