Row Selector

Qubes 7.5 Provide single and multi-selection capability in a List View Layer.

Properties

PropertyDescription
EnabledBoolean indicating whether or not the component is enabled.
FullRowSelectSpecifies if the selector is active on the full row (boolean).
HintSpecifies the user hint string that will appear in the component's interactive help bubble.
MultiSelectIndicates if multiple lines can be selected simultaneously (boolean).
TabIndexInteger indicating the component's tab order (Qubes 5.6).
ValueCheckedValue of the component when it is checked.
ValueInitialDetermines the component's initial value when the screen opens and each time it is reset (see Reset Button).
ValueUncheckedValue of the component when it is not checked.
VisibleBoolean indicating whether or not the component will be visible.

Value

When checked, the value is ValueChecked otherwise it is ValueUnchecked.

Remarks

This component is only available in List View layers.

Note that the Row Selector has no visual effect by default, you have to use presentation formulas to specify which colors or effects to use to make the selection visible.

When FullRowSelect is true, then the component will react on any click on the whole list view row (though components and hyperlinks in front may intercept the click). If multiple selectors are set to FullRowSelect in the same List View, then the behavior is undetermined.

MultiSelect controls single or multi-selection mode:

  • in single selection mode (MultiSelect = False), the selector is checked for only zero or one row, and the active row cannot be deselected.
  • in multi selection mode (MultiSelect = True), each click will toggle a row between the checked and unchecked state.

The Hyperlink property can be used to setup an hyperlink on the row selector (Qubes 9.0 after versions 9.2022.208), see Hyperlink in Grid Layer for details and capabilities.

Classification

Standards