Sfairadora

  • Reference Guide

Value Selection

Value selection is a simplified version of the disp-folder. It is a line editor with a button on the right, used to unfold a list of available values (this kind of dispel is sometimes called a “combo-box”). The list can be either a predefined list of constant values or a dynamic list determined by the contents of a designated table in the document.

Functionality

Item
Description
Object name
Name of the object where the edited data item is stored. You can select one of the objects provided by parent dispels.
Data reference
Reference to data within the above identified object.
Unfolding button
If checked, an unfolding button is displayed to the left of the line editor; the unfolding button unfolds the contents of the list so that it is displayed instead of the line editor as a set of radio buttons.
Disable text editing
If checked, the line editor merely shows the current selection, but the value cannot be changed. You can use this option to ensure that only values from the list can be selected.
Find text for value
If checked, value label specified in the values list is displayed in the line editor (the Title field) instead of the actual value. If unchecked, the actual value is displayed just like in a normal line editor.
Disable closing volatile window
If the line editor is in a volatile window – that is, in a window that is automatically closed when an action in the window is performed (such as the menu window), then, when this option is checked, the window will not be closed when the user selects a value.
Values
Selection type
Determines how the list of available values is created. You can choose between from list and from table. The remaining settings depend on this choice.

Selecting Value from List

Values
Uniform value type
If you specify a type here, all values in the subsequent list will be of this type. If no type is specified, you can select the type individually for every item in the list.
Table of values
Title
Value label displayed when the user selects values from the list.
Item type
You can choose between value and nested menu. If you choose nested menu, a button appears in the Value column opening a window with a subordinate table of values.
Value
Value assigned to the given item.
Details
All settings for the given item. They are explained in the following table.

Details of Rows in the Table of Values

Item
Description
Title
Value label – see above.
Icon
Value icon. If specified, it is displayed in the list to the left of the value label instead of the standard bullet symbol. The icon is defined in the icon editor.
Separator
If checked, the list item is separated from the preceding item by a line. This option is ignored for the first element in the list as no line is displayed above the first element.
Item type
See above – either value or nested menu. The remaining settings depend on this choice.
Item type = value
Value
Item value – see above.
Displayed icon
Icon displayed for the displayed title (see the next item). The icon is entered using the icon editor.
Displayed title
If the Find text for value option is on, this text is displayed for the given value in the line editor. If this text is not specified, the normal title specified above is used.
The distinction between the displayed title and the normal title allows you to display abbreviated information about the selected item while the item is described in more detail in the menu.
Item type = nested menu
Nested menu unfolded
If checked, the nested menu defined here is initially displayed as an unfolded list. If unchecked, a folded subordinate menu is displayed. The user can switch between these two states as required.
Nested menu values
Table of values – same as described above.

Selecting Value from Table

Item
Description
Object name of table data
Name of the object containing the table determining the list of values. You can select one of the objects provided by parent dispels. Every row of the selected table represents one item in the list of values.
Reference of table data
Reference to a table within the above identified object.
Value
Reference to the column of the designated table determining the values of the items in the list. The reference is relative to the table element, so usually it is simply the name of a column.
If you define this option by means of an expression, the expression is evaluated in the context of the inferred sequence data type. Therefore, a row in the source table is identified by the src object name. The same applies to the Title in selection and Displayed title settings.
Title in selection
Reference to a column of the designated table determining the labels of the items in the list. The column should be of the String or Rich_string type. If the type is different, standard type conversion is applied.
Displayed title
Reference to a column of the designated table determining the text displayed in the line editor if the respective value is currently selected. The reference need not be specified – the displayed titles are then the same as the titles in selection.
Other
Filter, order, unicity
These settings allow you to define a subset of table rows to be used in the list of available values. See the chapter on inferred sequence for details.