L_DispContainerRemoveBitmapRegion

#include "l_bitmap.h"

L_LTIVW_API L_INT EXT_FUNCTION L_DispContainerRemoveBitmapRegion(hCellWnd, nSubCellIndex, uFlags)

HWND hCellWnd;

/* handle to the cell window */

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

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. 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:

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_V17_OR_LATER
#if defined (LEADTOOLS_V16_OR_LATER)
L_INT DispContainerRemoveBitmapRegionExample(HDISPCONTAINER hCon)
{
   if (L_DispContainerGetCellCount(hCon, 0) == 0)
   {
      MessageBox(NULL, TEXT("you must at least have one cell added to the viewer"), TEXT("No Cell attached"), MB_OK);
      return FAILURE;
   }

   HWND hCellWnd = L_DispContainerGetCellWindowHandle(hCon, 0, 0);

   L_INT nRet = L_DispContainerRemoveBitmapRegion(hCellWnd, -1, 0);

   return nRet;
}
#endif

#else



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

   return nRet;
}
#endif

#endif