![]() |
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 );
A pointer to the new data for a cell.
The length in bytes of the new data.
The coordinates of the cell to hold the new data.
The list containing the cell given in the theCell parameter.
Any previous cell data in theCell is replaced. If there is insufficient memory in the heap, the function may fail to set the cells 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.
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.
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.