Working With Lists

Many tasks in the software make use of lists of items. Lists contain an ordered series of items, where there may be no items present, one item, or more. Generally each element is of the same type - for example the phases in a profile, the samples or targets in a experiment, the analyses in a experiment, etc.

Single Column Lists

Some lists are displayed as single items, in a single column, for example phases in a profile:

image alt text

Multiple Column Lists

Other lists have multiple columns, forming a table, for example the samples in a experiment:

image alt text

Selection Within A List

Single Selection

Lists often support selection. Click on a single item of the list (or anywhere in a row of a table) will select that item. The keyboard’s arrow keys can be used to move the selection through the list.

Multiple Selection

Some lists may support selection of multiple items.To select a range, move over the first item to be selected, and hold down the left mouse button. Drag the mouse to the last item to be selected, and release the mouse. Alternatively, click on the first item to be selected, then hold the Shift key and click the last item to be selected

Adding and Removing Items

Items may be added or removed from the selection by holding the Ctrl key (on OS X, use the cmd key instead) and left clicking the item. All items may be selected by clicking anywhere in the list, then holding the Ctrl key and pressing the A key.

Multiple Displays

Where lists support selection, there may be multiple displays which share the same selection. For example, in many analyses, selecting the rows for a certain set of wells in the results table will also select the same wells in associated graphs and plate displays.

Editing Lists

Each list display may have an associated set of buttons for editing the list. These always have icons, and in some lists also have text descriptions. They may be displayed horizontally or vertically, depending on the context. These buttons have the same effect, regardless of arrangement.

Adding Items

The Add button, with a “+” icon, will add a new item to the list. If one or more items are selected in the list, then the new item will be added immediately after the last selected item. If no item is selected, the new item will be added to the end of the list.

Deleting Items

The Delete button, with a “-” icon, will delete any selected items from the list. If not items are selected, it will have no effect, and is disabled.

Moving Items Upwards

The Up button, with an up arrow icon, will move the selected item one place earlier in the list. If there is no selected item, or the selected item is first in the list, it will have no effect and is disabled.

Moving Items Downwards

The Down button, with a down arrow icon, will move the selected item one place later in the list. If there is no selected item, or the selected item is last in the list, it will have no effect and is disabled.

Editing Items

Some lists will allow editing of the selected item using an editor displayed next to the list. For example, when a phase is selected in a profile, an editor is displayed next to the phase list to edit the details of the selected phase:

image alt text

This concludes the section on Working with Lists. For more details on tables (lists which have multiple columns), please see Working with Tables.