#include "ltivw.h"
L_LTIVW_API L_INT L_DispContainerGetCellPosition(hCon, nCellIndex, puRow, puCol, uFlags)
Retrieves the column and row number for the cell with the specified index.
Handle to the container.
A zero-based index of the cell for which to get the position.
Pointer to a variable to be updated with the vertical position (row) of the specified cell. Row numbering starts with 1.
Pointer to a variable to be updated with the horizontal position (column) of the specified cell. Column numbering starts with 1.
Reserved for future use. Pass 0.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
The row and column numbers obtained by this function are relative to the first cell in the container.
Required DLLs and Libraries
This function scroll down or up in order to make the cell become visible
L_INT DispContainerGetCellPositionExample(HDISPCONTAINER hCon,
L_INT nCellIndex)
{
L_INT nRet;
L_INT nCount;
L_UINT uRow;
L_UINT uCol;
DISPCONTAINERPROPERTIES DispContainerProp;
// Get Cells Count
nCount = L_DispContainerGetCellCount (hCon, 0);
if ((nCellIndex < 0) || (nCellIndex >= nCount))
return 0;
// get the row count of the container
DispContainerProp.uStructSize = sizeof(DISPCONTAINERPROPERTIES);
DispContainerProp.uMask = DCPF_NUMROWS;
nRet = L_DispContainerGetProperties (hCon, &DispContainerProp, 0);
if(nRet != SUCCESS)
return nRet;
// get the row and the col position
nRet = L_DispContainerGetCellPosition(hCon, nCellIndex, &uRow, &uCol, 0);
if(nRet != SUCCESS)
return nRet;
nRet = L_DispContainerSetFirstVisibleRow (hCon, max(0, ((L_INT)uRow - (L_INT)DispContainerProp.uNumRows + 1)), 0);
if(nRet != SUCCESS)
return nRet;
return SUCCESS;
}