Carbon


LSetCell

Header: Lists.h Carbon status: Supported

Changes the data contained in a cell.

void LSetCell (
    const void *dataPtr, 
    SInt16 dataLen, 
    Cell theCell, 
    ListHandle lHandle
);
Parameter descriptions
dataPtr

A pointer to the new data for a cell.

dataLen

The length in bytes of the new data.

theCell

The coordinates of the cell to hold the new data.

lHandle

The list containing the cell given in the theCell parameter.

DISCUSSION

Any previous cell data in theCell is replaced. If there is insufficient memory in the heap, the function may fail to set the cell’s data. If the cell coordinates specified by the theCell parameter are invalid, the function does nothing.

If the data of a visible cell is changed and the automatic drawing mode is enabled, the function updates the list.

SPECIAL CONSIDERATIONS

This function is contained in a resource of resource type 'PACK'. Calling it could result in the loading of the package resource and the allocation of memory. Thus, your application should not call this function from within an interrupt, such as in a completion function or VBL task.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)