LImageViewerCell::SetCellBitmapList

#include "ltwrappr.h"

L_INT LImageViewerCell::SetCellBitmapList (hBitmapList, bCleanImages, uFlags);

Attaches a bitmap list to the cell at the specified index.

Parameters

HBITMAPLIST hBitmapList

Handle to the list of bitmaps, which will be attached to the cell. Pass NULL to remove the current bitmap list.

Removing the current bitmap list will not free the attached image(s). The value in the bCleanImages parameter determines whether the image(s) associated with the removed bitmap list are also freed.

L_BOOL bCleanImages

Flag that specifies whether to free the bitmap list that was previously attached to the cell. Possible values are:

Value Meaning
TRUE Free the bitmap list that was previously attached to the cell.
FALSE Do not free the bitmap list that was previously attached to the cell.

L_UINT uFlags

Reserved for future use. Pass 0.

Returns

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

Comments

It is best not to modify an existing bitmap list attached to a specific cell. However, if it is necessary to modify an attached bitmap list, follow the steps below:

  1. Get the bitmap list using the function LImageViewerCell::GetCellBitmapList.
  2. Call LImageViewerCell::SetCellBitmapList with hBitmapList set to NULL and bCleanImages set to FALSE.
  3. Modify the bitmap list as needed.
  4. Reattach the bitmap list using LImageViewerCell::SetCellBitmapList.

If the cell already has a bitmap list and you call this function with hBitmapList set to another valid list of bitmaps and bCleanImages set to TRUE, this function frees the current attached list and attaches the new list to the cell.

If the cell already has a bitmap list and you call this function with hBitmapList set to another valid list of bitmaps and bCleanImages set to FALSE, this function will just overwrite the current list of bitmap with the new list of bitmaps. and the current list will just take up memory until the application ends.

Required DLLs and Libraries

Help Version 20.0.2019.3.12
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2019 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Medical Image Viewer C++ Class Library Help