Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

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 macroSelector
_Pack0$0024


Previous Book Contents Book Index Next

© Apple Computer, Inc.
6 JUL 1996