Important: The information in this document is obsolete and should not be used for new development.
LGetSelect
You can use theLGetSelect
function to get information about which cells are selected.
FUNCTION LGetSelect (next: Boolean; VAR theCell: Cell; lHandle: ListHandle): Boolean;
next
- A Boolean value that indicates whether
LGetSelect
should check only the cell specified by the parametertheCell
(next = FALSE
), or whether it should try to find the next selected cell (next = TRUE
).theCell
- On input, specifies the first cell whose selection status should be checked. If
next
isTRUE
, then this parameter on output indicates the next selected cell greater than or equal to the cell specified on input. Otherwise, this parameter remains unchanged.lHandle
- The list in which the selection is being checked.
DESCRIPTION
The behavior of theLGetSelect
function depends on the value specified in thenext
parameter.If
next
isTRUE
, thenLGetSelect
searches the list for the first selected cell beginning at the cell specified bytheCell
. (In particular,LGetSelect
first checks cells in rowtheCell.v
, and then cells in the next row, and so on.) If it finds a selected cell,LGetSelect
returnsTRUE
and sets the parametertheCell
to the coordinates of the selected cell. If it does not find a selected cell,LGetSelect
returnsFALSE
.If
next
isFALSE
, thenLGetSelect
checks only the cell specified by the parametertheCell
. If the cell is selected,LGetSelect
returnsTRUE
. Otherwise, it returnsFALSE
.SPECIAL CONSIDERATIONS
You should not call theLGetSelect
function from within an interrupt, such as in a completion routine or VBL task.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for theLGetSelect
function are
Trap macro Selector _Pack0 $003C SEE ALSO
For examples that determine which items are selected in a list, see "Working With List Selections" beginning on page 4-25.