#include "l_bitmap.h"
L_LTIVW_API HBITMAP EXT_FUNCTION L_DispContainerPrintSubCell(hCellWnd, nSubCellIndex, uFlags)
Returns a printable version of the specified sub-cell.
A handle to the window that represents the cell on which the function's effect will be applied.
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.
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. |
CONTAINER_PRINTCELL_NONE | [0x00000000] None. |
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
Platforms
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
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);
HBITMAP hBitmap = L_DispContainerPrintSubCell(hCellWnd, 0, CONTAINER_PRINTCELL_ALL ^ CONTAINER_PRINTCELL_ANNOTATION);
return hBitmap;
}