Carbon


LActivate

Header: Lists.h Carbon status: Supported

Activates or deactivates a list.

void LActivate (
    Boolean act, 
    ListHandle lHandle
);
Parameter descriptions
act

Indicates whether the list should be activated. Specify TRUE to activate the list. Specify FALSE to deactivate the list.

lHandle

The list to be activated or deactivated.

DISCUSSION

If a list is being deactivated, this function removes highlighting from selected cells and hides the scroll bars. If a list is being activated, the function highlights selected cells and shows the scroll bars.

This function has no effect on a list’s size box, if one exists.

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)