Legacy Document

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

Inside Macintosh: More Macintosh Toolbox /

Chapter 4 - List Manager / List Manager Reference

List Manager Routines / Accessing and Manipulating Cell Data

LAddToCell
You can use the LAddToCell 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
The LAddToCell procedure appends dataLen bytes of data beginning at the location specified by dataPtr to data already contained in the cell specified by the parameter theCell.
If the cell coordinates specified by the parameter theCell are invalid, then the LAddToCell 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 the LAddToCell 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 LAddToCell procedure are
Trap macro Selector
_Pack0 $000C