Item Selector
Used to select a Qubes item.
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. |
| Family | Limits the list to items in the specified family. |
| 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. |
| 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. |
| State | Limits the list to items with the specified state (see below) (Qubes 5.6) |
| SubFamily | Limits the list to items in the specified sub-family. |
| 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
| Name | Description |
| ID | Item identifier |
| GPAOID | Item GPAO identifier |
| NAME | Item name |
| DESCRIPTION | Description of the item |
| SUB_FAMILY | Item sub-family name |
| FAMILY | Item family name |
List of item states
| Value | Description |
| Any | All items |
| Active | Active item |
| Inactive | Inactive item |
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
The Family filter is applied to the family name or identifier (ID).
The SubFamily filter is applied to the sub-family name or identifier (ID).
For the State filter:
- it can be a simple state of a list of multiple states;
- if empty, it will filter for active items;
- if a filtered state does not appear in the above list, that state will be ignored.
ID's column is not displayed by default, even with SelectorColumns=* so you have to explicitly specify this column in order to display it.