![]() |
LNextCell |
||||
Header: | Lists.h | Carbon status: | Supported | |
Finds the next cell in a given row, in a given column, or in an entire list.
Boolean LNextCell ( Boolean hNext, Boolean vNext, Cell *theCell, ListHandle lHandle );
Indicates whether the function should check columns other than the current column. To get the next cell in a row, set this parameter to TRUE and set vNext to FALSE. The function then tries to find a cell whose coordinates are greater than those of the cell specified in theCell parameter but that is in the same row as theCell.
To get the next cell in a column, set this parameter to FALSE and set vNext to TRUE. The function then tries to find a cell whose coordinates are greater than those of the cell specified in theCell but that is in the same column as theCell.
To get the next cell in a list, set both this parameter and vNext to TRUE. This function then tries to find a cell whose coordinates are greater than those of the cell specified in the parameter theCell.
Indicates whether the function should check rows other than the current row. To get the next cell in a row, set this parameter to FALSE and set hNext to TRUE. The function then tries to find a cell whose coordinates are greater than those of the cell specified in theCell parameter but that is in the same row as theCell.
To get the next cell in a column, set this parameter to TRUE and set hNext to FALSE. The function then tries to find a cell whose coordinates are greater than those of the cell specified in theCell but that is in the same column as theCell.
To get the next cell in a list, set both this parameter and hNext to TRUE. This function then tries to find a cell whose coordinates are greater than those of the cell specified in the parameter theCell.
A pointer to the coordinates of the current cell. On return, a pointer to the next cell in the list, column or row being searched. If there are no more cells in the list, column or row, this parameter remains unchanged.
The list in which to find the next cell.
TRUE, if the function finds the next cell in the list, column or row being searched. FALSE, if the cell initially specified by theCell is the last in the row, column or list being searched. Also FALSE when both hNext and vNext are FALSE.
This function is contained in a resource of resource type 'PACK'. Calling it could result in the loading of the package resource and the allocation of memory. Thus, your application should not call this function from within an interrupt, such as in a completion function or VBL task.
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)