Enumerated List Selector
Used to select a value from a Qubes enumerated list.
Properties
| Property | Description |
| AutoCompleteMode | Defines how the selectors behave. There are two possible values: Start / Contains. |
| Enabled | Boolean indicating whether or not the component is enabled. |
| Document | Document defining the enumerated list. |
| FormatDisplayValue | Macro string defining a display format for the text in the selector's text zone. Only the fields used to define display formats will be used to filter the elements in the selector list. |
| Filter | Filters the returned values (a list of filters can be defined). Filters must use the syntax [field name] [operator] [value]. The possible operators are: = , <> , >= , <=, contains , not contains, startingwith, not startingwith. |
| FormatSelectValue | Macro string defining a display format for an element in the selector list. These fields are not used to filter the elements in the selector list. |
| FormatResultValue | Macro string defining a format for the value returned by the selector. |
| Hint | Specifies the user hint string that will appear in the component's interactive help bubble. |
| SelectorColumns | List of fields to display as columns in the selector table that opens when the user clicks on a selector's button. |
| 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. |
List of available fields
The available fields are those defined in the document describing the enumerated list.
Value
The component returns the value defined by the FormatResultValue property, if the selection is valid; if not, it will return an empty string.
Remarks
You must enter the unique document ID, or else the ID of a Qubes enumerated list document, as the Document attribute. The document that is used will always be the version currently in use.
Examples
To filter for a list's "code" field (starting with a fixed "rand" string) and its "num" field (cell A2), the "filter" syntax is:
=List('code startingwith rand';'num='+A2)