Returns a printable version of the specified sub-cell.


#include "ltivw.h"

L_LTIVW_API HBITMAP EXT_FUNCTION L_DispContainerPrintSubCell(hCellWnd, nSubCellIndex, uFlags)


L_HWND hCellWnd

A handle to the window that represents the cell on which the function's effect will be applied.

L_INT nSubCellIndex

A zero-based index into the image list attached to the cell specified in nCellIndex. This sub-cell will be printed. Pass -1 to print the entire cell. Pass -2 to print the selected sub-cell.

L_UINT uFlags

Flag that indicate which part of the cell to print. You can use a bitwise OR ( | ) to specify one or more flags from each group.

The following are the flags that indicates which part of the cell is going to be printed:

Value Meaning
CONTAINER_PRINTCELL_ALL [0x0000001F] Print everything on the cell of the returned HBITMAP.
CONTAINER_PRINTCELL_REGION [0x00000001] Print the region.
CONTAINER_PRINTCELL_ANNOTATION [0x00000002] Print the annotation if any.
CONTAINER_PRINTCELL_BORDERS [0x00000004] Print the border.
CONTAINER_PRINTCELL_TAG [0x00000008] Print the tags.
CONTAINER_PRINTCELL_RULERS [0x00000010] Print the ruler.

The following flag is used to resize the sub-cell to fit the entire cell area when printed. This value is ignored if nSubCellIndex is set to -1.

Value Meaning
CONTAINER_PRINTCELL_EXPLODED [0x00000020] Expand the sub-cell to fit the entire cell area.


Value Meaning
HBITMAP The function was successful.
NULL An error occurred. Refer to Return Codes. To get the error call GetLastError() function.


You can print any sub-cell even if it is not currently being viewed.

To print the entire cell, call L_DispContainerPrintCell function.

Required DLLs and Libraries


The toolkit comes in Win32 and x64 editions that can support development of software applications for any of the following environments:

Windows 10

Windows 8

Windows 7

Windows Vista

Windows XP

Windows 2000

See Also




This example print the first sub-cell of the first cell without including the annotation if any exist

HBITMAP DispContainerPrintSubCellExample(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 NULL; 
   HWND hCellWnd = L_DispContainerGetCellWindowHandle(hCon, 0, 0); 
   return hBitmap; 

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

LEADTOOLS Medical Image Viewer C API Help

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.