Simple List
Used to select an alternative from a simple list.
Properties
| Property | Description |
| Enabled | Boolean indicating whether or not the component is enabled. |
| Hint | Specifies the user hint string that will appear in the component's interactive help bubble. |
| Items | Specifies the list of selectable values (list, range, etc.). |
| Labels | Optionally specifies the labels of selectable values (Qubes 9.0). |
| Multiple | Boolean that indicates if there is the possibility to choose multiple values (Qubes 10.0). |
| TabIndex | Integer indicating the component's tab order (Qubes 5.6). |
| ValueInitial | Determines the component's initial value when the screen opens and each time it is reset (see Reset Button). |
| Visible | Boolean indicating whether or not the component will be visible. |
Value
The component's value is the value of the selected element.
If Multiple's value is true, the component's value is a list of the selected elements' values (Qubes 10.0).
Remarks
The Items property expects a list value or range value.
A simple list shows several alternatives simultaneously. To show a single alternative at a time, see Drop-Down List.
For the presentation of alternatives checkbox and radio button components are also available.
When Labels is defined, it will be displayed in place of the Items values for selection. This can be useful when Items are internal codes rather than end-user labels, or when localization is desired.
It is expected that Items and Labels have the same number of entries, if they do not, the number of visible entries is the max of Items and Labels, for each entry:
- if a label exists it will be used for display, otherwise the item is used
- if an item exists it will be used for the value, otherwise the label is used