L_DispContainerSelectCell

Summary

Selects or deselects the cell at the specified index.

Syntax

L_LTIVW_API L_INT L_DispContainerSelectCell(hCellWnd, bSelect, uFlags)

Parameters

L_HWND hCellWnd

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

L_BOOL bSelect

Flag that indicates whether to select or deselect the cell at the specified index. Possible values are:

L_UINT uFlags

Reserved for future use. Pass 0.

Returns

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_DispContainerInsertCell
• L_DispContainerRemoveCell
• L_DispContainerGetCellCount
• L_DispContainerGetCellWindowHandle
• L_DispContainerSetCellBitmapList
• L_DispContainerSetCellTag
• L_DispContainerSetCellProperties
• L_DispContainerGetCellProperties
• L_DispContainerGetCellPosition
• L_DispContainerRepositionCell
• L_DispContainerGetCellBitmapList
• L_DispContainerGetCellBounds
• L_DispContainerFreezeCell
• L_DispContainerIsCellFrozen
• L_DispContainerIsCellSelected

Topics

• Image Viewer Cells
• Image Viewer Functions: Image Viewer Cells

Example

This procedure inverses the selection.

L_INT DispContainerSelectCellExample(HDISPCONTAINER hCon)  
{ 
   L_INT nRet; 
   // Get the cells count.  
   L_INT nCount = L_DispContainerGetCellCount (hCon, 0);  
   L_INT nI;  
 
   for (nI = 0; nI < nCount; nI++) 
   { 
      HWND hCellWnd = L_DispContainerGetCellWindowHandle(hCon, nI, 0); 
 
      // if there is a selected cell make it unselected and vice versa 
      L_BOOL bSelected = L_DispContainerIsCellSelected (hCellWnd, 0);  
      nRet = L_DispContainerSelectCell(hCellWnd, !bSelected, 0);  
      if(nRet != SUCCESS) 
         return nRet; 
   } 
   return SUCCESS; 
}