| Command group | Flag affected | Reversible | Execute on client | Platform(s) |
|---|---|---|---|---|
| List lines | YES | NO | NO | All |
Save selection for line(s) ([All lines]) {line-number (calculation)}
| All lines | If specified, the command affects all the lines in the list |
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.
This command saves the selection state of the specified line(s) in memory and sets the flag. 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.
Save selection for line(s) allows the selection state of the specified line (or All lines) to be copied into the Saved set. You can specify a particular line in the list by entering either a number or a calculation. If the line number is not specified, the current line selection is saved. The All lines option saves the selection for all lines of the current list. This example selects the middle line of the list:
# Save and restore the selection after all an invert
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) {3}
Select list line(s) {5}
Save selection for line(s) (All lines)
Invert selection for line(s) (All lines)
Restore selection for line(s) (All lines)