Help Version 19.0.2017.10.27
References ▼
#include "ltivw.h"
L_LTIVW_API L_INT L_DispContainerGetCellPosition(hCon, nCellIndex, puRow, puCol, uFlags)
HDISPCONTAINER hCon; |
handle to the container |
L_INT nCellIndex; |
index of the cell |
L_UINT * puRow; |
pointer to a variable to be updated |
L_UINT * puCol; |
pointer to a variable to be updated |
L_UINT uFlags; |
reserved for future use |
Retrieves the column and row number for the cell with the specified index.
Parameter |
Description |
hCon |
Handle to the container. |
nCellIndex |
A zero-based index of the cell for which to get the position. |
puRow |
Pointer to a variable to be updated with the vertical position (row) of the specified cell. Row numbering starts with 1. |
puCol |
Pointer to a variable to be updated with the horizontal position (column) of the specified cell. Column numbering starts with 1. |
uFlags |
Reserved for future use. Pass 0. |
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
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. |
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 CountnCount = L_DispContainerGetCellCount (hCon, 0);if ((nCellIndex < 0) || (nCellIndex >= nCount))return 0;// get the row count of the containerDispContainerProp.uStructSize = sizeof(DISPCONTAINERPROPERTIES);DispContainerProp.uMask = DCPF_NUMROWS;nRet = L_DispContainerGetProperties (hCon, &DispContainerProp, 0);if(nRet != SUCCESS)return nRet;// get the row and the col positionnRet = 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;}