Carbon


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
);
hNext

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.

vNext

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.

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.

lHandle

The list in which to find the next cell.

function result

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.

SPECIAL CONSIDERATIONS

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.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.


© 2000 Apple Computer, Inc. — (Last Updated 3/23/2000)