User Selector
Used to select a Qubes user.
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. |
| 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. |
| TabIndex | Integer indicating the component's tab order (Qubes 5.6). |
| UserStatus | Display the users that have the status listed. List of strings which can be "ACTIVE", "SUSPENDED" or "CANCELED" (Qubes 11.0) |
| 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 | User identifier |
| LASTNAME | User last name |
| FIRSTNAME | User first name |
| LOGIN | User login |
| MANAGER | Manager's login |
| MAINSERVICE | User's main service |
| MAINSITE | User's main site |
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 list of users is limited to active Qubes users (before Qubes 11.0).
(Qubes 11.0) The optional "STATUS" column field can be displayed with SelectorColumns but not used with the other properties.