L_DispContainerCreateCell

#include "ltivw.h"

L_LTIVW_API L_HWND L_DispContainerCreateCell(hWndParent, uFlags);

L_HWND hWndParent;

handle to the parent window

L_UINT uFlags;

reserved for future

Creates a cell, which is a window that will contain the image. Each cell can hold a single image or a list of images.

Parameter

Description

hWndParent Handle to the parent or owner window of the container window being created.
uFlags Reserved for future. Must be 0.

Returns

>0 A handle to the cell window.
NULL An error occurred. To get extended error information, call GetLastError and Refer to Return Codes.

Comments

The newly created cell will be empty. To add a bitmap list to it, use the function L_DispContainerSetCellBitmapList.

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.
See Also
Functions: L_DispContainerCreate, L_DispContainerGetWindowHandle, L_DispContainerDestroy, L_DispContainerSetProperties, L_DispContainerGetProperties, L_UseContainerControl, L_DispContainerGetHandle
Topics: Image Viewer Cells
Image Viewer Functions: Image Viewer Cells

Example

This function creates a new cell.

L_INT L_DispContainerCreateCellExample(HDISPCONTAINER hCon, 
HBITMAPLIST  * hBitmapList, 
L_INT          nCellIndex) 
{ 
   L_INT nRet; 
   L_INT nCount = L_DispContainerGetCellCount (hCon, 0); 
   // Check the validity of the cell index 
   if ((nCellIndex < 0) || (nCellIndex >= nCount)) 
      return 0; 
   HWND hParent = L_DispContainerGetWindowHandle(hCon, 0); 
   HWND hCellWnd = L_DispContainerCreateCell(hParent, 0); 
   // retrieve the bitmap list. 
   nRet = L_DispContainerGetCellBitmapList(hCellWnd, hBitmapList, 0); 
   if(nRet != SUCCESS) 
      return nRet; 
   nRet = L_DispContainerInsertCell(hCon, hCellWnd, 0, 0); 
   if(nRet != SUCCESS) 
      return nRet; 
   return SUCCESS; 
} 

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Medical Image Viewer C API Help