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 / Accessing and Manipulating Cell Data


LSetCell

You can use the LSetCell procedure to change the data contained in a cell.

PROCEDURE LSetCell (dataPtr: Ptr; dataLen: Integer; theCell: Cell;
                    lHandle: ListHandle);
dataPtr
A pointer to the new data for a cell.
dataLen
The length in bytes of the data pointed to by the dataPtr parameter.
theCell
The coordinates of the cell to hold the new data.
lHandle
The list containing the cell given in the theCell parameter.
DESCRIPTION
The LSetCell procedure sets the data of the cell specified by the parameter theCell to dataLen bytes of data beginning at the location specified by dataPtr. Any previous cell data in theCell is replaced.

If the cell coordinates specified by the theCell parameter are invalid, then LSetCell does nothing.

WARNING
If there is insufficient memory in the heap, the LSetCell procedure may fail to set the cell's data.
If the data of a visible cell is changed and the automatic drawing mode is enabled, LSetCell updates the list.

SPECIAL CONSIDERATIONS
You should not call the LSetCell 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 LSetCell procedure are
Trap macroSelector
_Pack0$0058

SEE ALSO
For an example that sets the data of cells in a list, see Listing 4-4 on page 4-22.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
6 JUL 1996