Important: The information in this document is obsolete and should not be used for new development.
LSetCell
You can use theLSetCell
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
TheLSetCell
procedure sets the data of the cell specified by the parametertheCell
todataLen
bytes of data beginning at the location specified bydataPtr
. Any previous cell data intheCell
is replaced.If the cell coordinates specified by the
theCell
parameter are invalid, thenLSetCell
does nothing.
If the data of a visible cell is changed and the automatic drawing mode is enabled,
- WARNING
- If there is insufficient memory in the heap, the
LSetCell
procedure may fail to set the cell's data.LSetCell
updates the list.SPECIAL CONSIDERATIONS
You should not call theLSetCell
procedure from within an interrupt, such as in a completion routine or VBL task.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for theLSetCell
procedure are
Trap macro Selector _Pack0 $0058 SEE ALSO
For an example that sets the data of cells in a list, see Listing 4-4 on page 4-22.