LImageViewer::GetCellPosition

Summary

Retrieves the column and row number for the cell with the specified index.

Syntax

#include "ltwrappr.h"

L_INT LImageViewer::GetCellPosition (nCellIndex, puRow, puCol, uFlags);

Parameters

L_INT nCellIndex

A zero-based index of the cell for which to get the position.

L_UINT * puRow

Pointer to a variable to be updated with the vertical position (row) of the specified cell. Row numbering starts with 1.

L_UINT * puCol

Pointer to a variable to be updated with the horizontal position (column) of the specified cell. Column numbering starts with 1.

L_UINT uFlags

Reserved for future use. Pass 0.

Returns

Value Meaning
SUCCESS The function was successful.
< 1 An error occurred. To get extended error information, call GetLastError, and refer to Return Codes.

Comments

The row and column numbers obtained by this function are relative to the first cell in the container.

Required DLLs and Libraries

See Also

Functions

Topics

Example

This function scrolls down or up in order to make the cell become visible.

L_INT LImageViewer_GetCellPositionExample(LImageViewer& ImageViewer)  
 
{ 
   L_INT    nCellIndex = 0 ;  
   L_INT    nCount;  
   L_UINT   uRow;  
   L_UINT   uCol;  
   L_UINT   nRet;  
 
   DISPCONTAINERPROPERTIES DispContainerProp;  
 
   // Get Cells Count 
 
   nCount = ImageViewer.GetCellCount(0);  
 
   if ((nCellIndex < 0) || (nCellIndex >= nCount))  
 
      return FAILURE; 
 
   // get the row count of the container 
 
   DispContainerProp.uStructSize = sizeof(DISPCONTAINERPROPERTIES);  
 
   DispContainerProp.uMask = DCPF_NUMROWS;  
 
   nRet = ImageViewer.GetProperties(&DispContainerProp, 0);  
   if(nRet != SUCCESS) 
      return nRet; 
 
   // get the row and the col position 
 
   nRet = ImageViewer.GetCellPosition(nCellIndex, &uRow, &uCol, 0);  
   if(nRet != SUCCESS) 
      return nRet; 
 
   nRet = ImageViewer.SetFirstVisibleRow(max(0, ((L_INT)uRow - (L_INT)DispContainerProp.uNumRows + 1)), 0);  
   if(nRet != SUCCESS) 
      return nRet; 
 
   return SUCCESS; 
} 

Help Version 22.0.2022.12.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Medical Image Viewer C++ Class Library Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.