Important: The information in this document is obsolete and should not be used for new development.
LAddToCell
You can use theLAddToCell
procedure to append data to the data already contained in a cell.
PROCEDURE LAddToCell (dataPtr: Ptr; dataLen: Integer; theCell: Cell; lHandle: ListHandle);
dataPtr
- A pointer to the data to be appended.
dataLen
- The length in bytes of the data pointed to by the
dataPtr
parameter.theCell
- The coordinates of the cell to which the data should be appended.
lHandle
- The list containing the cell given in the
theCell
parameter.DESCRIPTION
TheLAddToCell
procedure appendsdataLen
bytes of data beginning at the location specified bydataPtr
to data already contained in the cell specified by the parametertheCell
.If the cell coordinates specified by the parameter
theCell
are invalid, then theLAddToCell
procedure does nothing.If the data of a visible cell is changed and the automatic drawing mode is enabled,
LAddToCell
updates the list.SPECIAL CONSIDERATIONS
You should not call theLAddToCell
procedure from within an interrupt, such as in a completion routine or VBL task.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for theLAddToCell
procedure are
Trap macro Selector _Pack0 $000C