#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.
Handle to the container.
A zero-based index of the current cell position.
A zero-based index of the new cell position.
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:
Value | Meaning |
---|---|
TRUE | Swap the cells. |
FALSE | Shift the cells. |
Reserved for future use. Pass 0.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
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:
bSwap value when nCellIndex = 2 and nTargetIndex = 6 | Cell order:1 2 3 ... 4 5 6 |
---|---|
TRUE | 1 6 3 4 5 2 |
FALSE | 1 3 4 5 6 2 |
Required DLLs and Libraries
This function shuffles the order of the cells
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;
}