Drop-Down List
Used to select an alternative from a drop-down 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). |
| 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.
Remarks
The Items property expects a list value or range value.
The drop-down list only shows one alternative at a time. To show several alternatives simultaneously, see Simple 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
(Qubes 10.0) For rendering versions >= 20230420, if the item list changes and the selected element isn't in the new list, the first item is selected by default.