Legacy Document

Inside Macintosh: More Macintosh Toolbox /

Chapter 4 - List Manager / List Manager Reference

List Manager Routines / Adding and Deleting Columns and Rows To and From a List

LDelRow

You can use the LDelRow procedure to delete one or more rows from a list.

PROCEDURE LDelRow (count: Integer; rowNum: Integer; 
                  lHandle: ListHandle);

count

The number of rows to delete, or 0 to delete all rows.

rowNum

The row number of the first row to delete.

lHandle

The list from which to delete the rows.

DESCRIPTION

The LDelRow procedure deletes the number of rows specified by the count parameter, starting at the row specified by the rowNum parameter.

If the row specified by rowNum is invalid, then nothing is done.

Your application can quickly delete all rows from a list (and thus delete all cell data) simply by setting the count parameter to 0. The number of columns is left unchanged. Your application can achieve the same effect by setting the rowNum parameter to lHandle^^.dataBounds.top and setting the count parameter to a value greater than lHandle^^.dataBounds.bottom - lHandle^^.dataBounds.top.

Rows whose row numbers are initially greater than rowNum have their row numbers decreased by count.

If the automatic drawing mode is enabled and one or more of the rows deleted by LDelRow are visible, then the list (including its scroll bars) is updated.

SPECIAL CONSIDERATIONS

You should not call the LDelRow 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 LDelRow procedure are

Trap macro	Selector
_Pack0	$0024