Carbon


LAddToCell

Header: Lists.h Carbon status: Supported

Appends data to the data already contained in a cell.

void LAddToCell (
    const void *dataPtr, 
    SInt16 dataLen, 
    Cell theCell, 
    ListHandle lHandle
);
dataPtr

A pointer to the data to be appended.

dataLen

The length in bytes of the data to be appended.

theCell

The coordinates of the cell to which the data should be appended.

lHandle

The list containing the cell given in the theCell parameter.

DISCUSSION

If the cell coordinates specified by the parameter theCell are invalid, then this 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 CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.


© 2000 Apple Computer, Inc. — (Last Updated 3/23/2000)