Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: More Macintosh Toolbox /
Chapter 4 - List Manager / List Manager Reference
List Manager Routines / Responding to Events Affecting Lists


LActivate

When your application receives an activate event for a window containing a list, it should activate or deactivate the list as appropriate. You can use the LActivate procedure to perform highlighting of the cells and to show or hide any scroll bars.

PROCEDURE LActivate (act: Boolean; lHandle: ListHandle);
act
A Boolean value that 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.
DESCRIPTION
The LActivate procedure activates the list specified by the lHandle parameter if act is TRUE and deactivates it otherwise.

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

The LActivate procedure has no effect on a list's size box, if one exists.

SPECIAL CONSIDERATIONS
You should not call the LActivate procedure from within an interrupt, such as in a completion routine or VBL task.

ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for the LActivate procedure are
Trap macroSelector
_Pack0$0000

SEE ALSO
For information on responding to activate events in lists, see "Responding to Events Affecting a List" beginning on page 4-23. For general information on events, see the chapter "Event Manager" in Inside Macintosh: Macintosh Toolbox Essentials.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
6 JUL 1996