Important: The information in this document is obsolete and should not be used for new development.
LDelRow
You can use theLDelRow
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
TheLDelRow
procedure deletes the number of rows specified by thecount
parameter, starting at the row specified by therowNum
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 therowNum
parameter tolHandle^^.dataBounds.top
and setting thecount
parameter to a value greater thanlHandle^^.dataBounds.bottom - lHandle^^.dataBounds.top
.Rows whose row numbers are initially greater than
rowNum
have their row numbers decreased bycount
.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 theLDelRow
procedure from within an interrupt, such as in a completion routine or VBL task.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for theLDelRow
procedure are
Trap macro Selector _Pack0 $0024