L_DispContainerRepositionCell

#include "ltivw.h"

L_LTIVW_API L_INT L_DispContainerRepositionCell(hCon, nCellIndex, nTargetIndex, bSwap, uFlags)

Sets the position of the specified cell, based on the index of the cell.

Parameters

HDISPCONTAINER hCon

Handle to the container.

L_INT nCellIndex

A zero-based index of the current cell position.

L_INT nTargetIndex

A zero-based index of the new cell position.

L_BOOL bSwap

Flag that indicates whether to perform swap on the cells specified in nCellIndex and nTargetIndex, or to shift the cells according to the parameters and then set the cell with nCellIndex, in the position of nTargetIndex.  Possible values are:

L_UINT uFlags

Reserved for future use. Pass 0.

Returns

Comments

Set the bSwap flag to TRUE to swap the nCellIndex and nTargetIndex. Otherwise the function will shift the cells and then place the cell with the cell index nCellIndex in the exposed area. See the following illustration:

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.

L_INT DispContainerRepositionCellExample(HDISPCONTAINER hCon)  
{ 
   L_INT nRet; 
   L_INT nI, nCount;  
 
   // Get Cells Count 
   nCount = L_DispContainerGetCellCount (hCon, 0); 
 
   srand((L_INT)GetCurrentTime()); 
 
   // Shuffles all the cells 
   for (nI = 0; nI < nCount; nI++) 
   { 
      nRet = L_DispContainerRepositionCell(hCon, nI, (rand() % nCount),TRUE, 0);  
      if(nRet != SUCCESS) 
         return nRet; 
   } 
    
   return SUCCESS; 
}