AND selected and saved

Command group Flag affected Reversible Execute on client Platform(s)
List lines YES NO NO All

Syntax

AND selected and saved ([All lines]) {line-number (calculation)}

Options

All lines If specified, the command affects all the lines in the list

Deprecated Command

This command has been deprecated and is no longer visible in the Code Assistant in the Code Editor (it will not appear when you type the first few characters), although it is still present in Omnis Studio and will continue to function if used in legacy code. You can show this command by disabling the appropriate Command Filter in the Modify menu in the Code Editor.

Description

This command performs a logical AND of the Saved selection with the Current selection. You can specify a particular line in the list by entering either a number or a calculation. The All lines option performs the AND for all lines of the current list.

To allow sophisticated manipulation of data via lists, a list can store two selection states for each line; the "Current" and the "Saved" selection. The Current and Saved selections have nothing to do with saving data on the disk; they are no more than labels for two sets of selections. The lists may be held in memory and never saved to disk: they will still have a Current and Saved selection state for each line but they will be lost if not saved. When a list is stored in the data file, both sets of selections are stored.

The list data structure contains the column definitions, the field values for each line of the list, the current selected status and saved selected status for each line, LIST.$lineLIST.$linecount and LIST.linemax.

The AND selected and saved command performs a logical AND on the saved and current state, and puts the result into the Current selection. Hence, for a particular line, if both the Current and Saved states are selected, the Current state remains selected, but if either or both states are deselected, the resulting Current state will become deselected.

Saved State Current State Resulting Current State
Selected Selected Selected
Deselected Selected Deselected
Selected Deselected Deselected
Deselected Deselected Deselected

Example

# Line 3 remains selected as it is the only line selected
# when both the 'Save selection for line(s)' and
# 'AND selected and saved' commands are used
Set current list lMyList
Define list {lCol1}
For lCol1 from 1 to 6 step 1
  Add line to list {lCol1}
End For
Select list line(s) (All lines)
Save selection for line(s) (All lines)
Deselect list line(s) (All lines)
Select list line(s) {3}
AND selected and saved (All lines)