Legacy Document

Inside Macintosh: More Macintosh Toolbox /

Chapter 4 - List Manager / List Manager Reference

List Manager Routines / Getting Information About Cells

LRect

You can use the LRect procedure to find a rectangle that encloses a cell. Because the List Manager automatically draws cells, few applications need to call this procedure directly.

PROCEDURE LRect (VAR cellRect: Rect; theCell: Cell; 
                 lHandle: ListHandle);

cellRect

The LRect procedure returns in this parameter 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.

lHandle

The list containing the cell specified by the parameter theCell.

DESCRIPTION

The LRect procedure calculates the coordinates of the rectangle enclosing the cell specified by the theCell parameter. The procedure does not check whether the cell is actually contained within the list's visible rectangle.

If the theCell parameter specifies cell coordinates not contained within the list, the LRect procedure sets the cellRect parameter to (0,0,0,0).

SPECIAL CONSIDERATIONS

You should not call the LRect procedure from within an interrupt, such as in a completion routine or VBL task.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the LRect procedure are

Trap macro	Selector
_Pack0	$004C