Legacy Document

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.