Carbon


LRect

Header: Lists.h Carbon status: Supported

Finds a rectangle that encloses a cell.

void LRect (
    Rect *cellRect, 
    Cell theCell, 
    ListHandle lHandle
);
cellRect

On return, a pointer to the rectangle enclosing the cell, specified in local coordinates of the list’s graphics port. This rectangle is not necessarily within the list’s rectangle.

theCell

The cell for which an enclosing rectangle is sought. This function does not check whether the cell is actually contained within the list’s visible rectangle.

If this parameter specifies cell coordinates not contained within the list, this function sets the cellRect parameter to (0,0,0,0).

lHandle

The list containing the cell specified by the parameter theCell.

DISCUSSION

Because the List Manager automatically draws cells, few applications need to call this function directly.

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)