Legacy Document

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

Inside Macintosh: More Macintosh Toolbox /

Chapter 4 - List Manager / List Manager Reference

List Manager Routines / Determining or Changing the Selection

LSetSelect
You can use the LSetSelect procedure to select or deselect a cell.
PROCEDURE LSetSelect (setIt: Boolean; theCell: Cell; 
                      lHandle: ListHandle);
setIt
A Boolean value that indicates whether the LSetSelect procedure should select or deselect the specified cell. Specify TRUE to select the cell; specify FALSE to deselect the cell.
theCell
The cell to be selected or deselected.
lHandle
The list containing the cell to be selected or deselected.

DESCRIPTION
If setIt is TRUE, then the LSetSelect procedure selects the cell specified by the theCell parameter in the list specified by lHandle. If the cell is already selected, LSetSelect does nothing.
If setIt is FALSE, then LSetSelect deselects the cell specified by theCell. If the cell is already deselected, LSetSelect does nothing.
If a cell's selection status is changed and the cell is visible, LSetSelect redraws the cell.

SPECIAL CONSIDERATIONS
You should not call the LSetSelect 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 LSetSelect procedure are
Trap macro Selector
_Pack0 $005C

SEE ALSO
For examples that change the items selected in a list, see "Working With List Selections" beginning on page 4-25.