filereq (File Requester, File Dialogs)

This attribute controls the choices of the user in a filereq object. If its value is true, the user can select multiple files. The selected files are then found in the indexed attribute .value[integer]. Normally, the selected file or directory is in the scalar attribute .value.

Particularities

This attribute is only supported on Microsoft Windows for the modes fr_load and fr_save, which is the selection of files.

listbox

This defines the selection type in a listbox, i.e. multiple selection or single selection.

If .multisel; is set at false, only one of the listbox items can be selected with a mouse click. If .multisel is set at true, several listbox items can be selected with a mouse click. If an item which has already been selected is selected again with a mouse click, the selection is reversed (deselected).

Remark on the IDM for Windows

If the cursor is moved up and down with the cursor keys in a listbox that has .multisel set at false, the item that has the focus is also selected.

tablefield

At the tablefield, .multisel controls whether several fields/columns/rows can be selected, depending on the selection types activated (details see object tablefield).

Multiple Selection in Motif

Multiselection is the selection of several different objects or a series of objects (e.g. items in a listbox) with only one single action.

1. To select several listbox items together which are not direct neighbors, select one item with the left mouse button and release the button. Then move on to the next item to be selected and press the Ctrl key and afterward the left mouse button to select the second item. This action can be repeated for any further number of items.

2. To select several following listbox items, select an item by the left mouse button; this item becomes the first in the series of items. The selected state of the item appears inverted. All previously selected listbox items are now deselected!

   If you keep the mouse button is pressed and move the mouse over further items, all items located between the first item and the current cursor position appear inverted, which shows that they are selected. The selection ends with the item on which the mouse button is released. All items between the first and last selected items are selected.

   The same effect is achieved if you move the cursor to the item which shall be the last in the row, beginning from the first selected item, and then press the Shift key, keep it pressed and then also press the left mouse button.

   Entries can be added or subtracted from a series of items already selected by the Ctrl key.

   Add

   After selecting the first item row, move the cursor to the first item in the new item row and press the Ctrl key and the left mouse button at the same time. The item in which the cursor is located appears inverted. Previous selections remain unchanged.

   Thus, if another row is to be selected after selecting the first one, the cursor must be moved to the corresponding positions: press the Ctrl key and execute the further action as described above in 1. and 2..

   Subtract

   Subtraction is carried out by reversing above actions. This means that the same procedures are used on already selected items.

   Set the cursor on the item to be deselected first, press the Ctrl key and afterward the left mouse button. The item on which the cursor is located de-inverts, i.e. it appears in normal state. If the mouse button is kept pressed and the cursor moved on, all items touching the cursor are deselected. The same effect is reached by moving the cursor to the relevant position, pressing the Shift key and then the left mouse button.

   The described selection procedures can also be used with the keyboard. The keyboard cursor (Tab), displayed in a frame, has to be moved into the listbox. In this mode, the left mouse button is replaced by the selection key Space. Otherwise the procedure is carried out as described above.

Example

Listbox.multisel  := true;
Listbox.active[I] := false;

See also

Attributes .active[integer], .activeitem, .selstyle