Controllers¶

The Controllers family is one of available components’ families you can use to populate a Mask.

It contains commands that enable specific interactions, allowing the master user to build guided procedures and the end user to interact with the custom interface.

What makes the Controllers family unique among all the other components is the fact that the Options available in the Options tab can be linked to them, assigning a default value.

Moreover, as Controllers can manage values, they are the only Origin allowed to make Connections work.

To make it easier to locate them, Controllers have been divided into two groups:

Base controllers, which manage one option at a time, of a specific type. Each controller generates a specific value type, so the controller itself decides whether a number, string, password for example will be managed by it or not.
Multiple controllers, which manage one or more options at a time, depending on the graphical interaction.

Base¶

The Base group contains the following controllers:

Checkbox
Text field
Number field
Password field
Color picker
Calendar field
Source control
Code field

The layout of Base controllers can be customized in the components layout menu, it can be accessed by right-clicking onto the component and clicking Open components layout or when first dragging the component onto the stage.

CHECKBOX

Option	Description
Label	The label of the checkbox.
Label width	The width (in pixels) of the label.
Option	Select from the drop-down list the option, among those which have been previously set in the Options tab, which will be linked to the checkbox.
Order	The position of the controller in the mask. It is a 0-based dictionary, and its default value is 0 for all components, meaning that the order of the components will follow the dragging order. If this value is specified, controllers will be sorted in ascending order according to the Order value.
Css	Additional CSS code used to customize the checkbox.

TEXT FIELD

Option	Description
Label	The label of the text field.
Label position	The position of the label. The possible values are: Start (default), Top, Bottom, End.
Label width	The width (in pixels) of the label.
Option width	The width (in pixels) of the field where the values will be inserted.
Default (with code None)	If the Option associated with the text field has no value, here users can specify a default value for the component.
Multiline	If selected, the text field will contain multiple lines.
Format	It checks the data type which will be inserted in the text field. For example, a Regex checking whether an email has been written correctly in the format `name + @ + dominion` can be inserted in this field.
Option	Select from the drop-down list the option, among those which have been previously set in the Options tab, which will be linked to the text field.
Order	The position of the controller in the mask. It is a 0-based dictionary, and its default value is 0 for all components, meaning that the order of the components will follow the dragging order. If this value is specified, controllers will be sorted in ascending order according to the Order value.
Css	Additional CSS code used to customize the text field.

NUMBER FIELD

Option	Description
Label	The label of the number field.
Label position	The position of the label. The possible values are: Start (default), Top, Bottom, End.
Label width	The width (in pixels) of the label.
Option width	The width (in pixels) of the field where the values will be inserted.
Min Value	The allowed minimum value of the number field.
Max Value	The allowed maximum value of the number field.
Default (with code None)	If the Option associated with the number field has no value, here users can specify a default value for the component.
Floating number (3-digits)	If selected, continuous numbers with up to 3 digits after the comma will be accepted.
Floating number (6-digits)	If selected, continuous numbers with up to 6 digits after the comma will be accepted.
Percentage value	If selected, the considered number will be a percentage.
Option	Select from the drop-down list the option, among those which have been previously set in the Options tab, which will be linked to the number field.
Order	The position of the controller in the mask. It is a 0-based dictionary, and its default value is 0 for all components, meaning that the order of the components will follow the dragging order. If this value is specified, controllers will be sorted in ascending order according to the Order value.
Css	Additional CSS code used to customize the number field.

PASSWORD FIELD

Option	Description
Label	The label of the number field.
Label position	The position of the label. The possible values are: Start (default), Top, Bottom, End.
Label width	The width (in pixels) of the label.
Option width	The width (in pixels) of the field where the values will be inserted.
Default (with code None)	If the Option associated with the password field has no value, here users can specify a default value for the component.
Multiline	If selected, the password field will contain multiple lines.
Format	It checks the data type which will be inserted in the password field. For example, a Regex checking whether an email has been written correctly in the format `name + @ + dominion` can be inserted in this field.
Option	Select from the drop-down list the option, among those which have been previously set in the Options tab, which will be linked to the password field.
Order	The position of the controller in the mask. It is a 0-based dictionary, and its default value is 0 for all components, meaning that the order of the components will follow the dragging order. If this value is specified, controllers will be sorted in ascending order according to the Order value.
Css	Additional CSS code used to customize the password field.

COLOR PICKER

Option	Description
Label	The label of the color picker.
Label width	The width (in pixels) of the label.
Option	Select from the drop-down list the option, among those which have been previously set in the Options tab, which will be linked to the color picker.
Order	The position of the controller in the mask. It is a 0-based dictionary, and its default value is 0 for all components, meaning that the order of the components will follow the dragging order. If this value is specified, controllers will be sorted in ascending order according to the Order value.
Css	Additional CSS code used to customize the color picker.

CALENDAR FIELD

Option	Description
Label	The label of the calendar field.
Label position	The position of the label. The possible values are: Start (default), Top, Bottom, End.
Label width	The width (in pixels) of the label.
Option width	The width (in pixels) of the field where the values will be inserted.
Date type	The allowed date format. Possible values are Date (default), Month, Week, Quarter, Datetime, Time.
Option	Select from the drop-down list the option, among those which have been previously set in the Options tab, which will be linked to the calendar field.
Order	The position of the controller in the mask. It is a 0-based dictionary, and its default value is 0 for all components, meaning that the order of the components will follow the dragging order. If this value is specified, controllers will be sorted in ascending order according to the Order value.
Css	Additional CSS code used to customize the calendar field.

SOURCE CONTROL

Option	Description
Label	The label of the controller.
Option	Select from the drop-down list the option, among those which have been previously set in the Options tab, which will be linked to the source control.
Order	The position of the controller in the mask. It is a 0-based dictionary, and its default value is 0 for all components, meaning that the order of the components will follow the dragging order. If this value is specified, controllers will be sorted in ascending order according to the Order value.
Css	Additional CSS code used to customize the source control.
Source type	Select from the drop-down list the type of source which will be supported. The available types are: Database (default) and Filesystem.
Export	Select this checkbox if the current controller will perform export operations.
Extensions (comma sep)	Specify the allowed file extensions.
File number limit (-1 means no limit)	The maximum number of files which can be managed by the source control. If -1 is specified, an infinite number of files can be managed.

CODE FIELD

Option	Description
Label	The label of the code field.
Label position	The position of the label. The possible values are: Start, Top (default), Bottom, End.
Label width	The width (in pixels) of the label.
Option width	The width (in pixels) of the field where the values will be inserted.
Language	The supported language in the code field.
Show Preview	If selected,
Automatic Preview	If selected,
Option	Select from the drop-down list the option, among those which have been previously set in the Options tab, which will be linked to the code field.
Order	The position of the controller in the mask. It is a 0-based dictionary, and its default value is 0 for all components, meaning that the order of the components will follow the dragging order. If this value is specified, controllers will be sorted in ascending order according to the Order value.
Css	Additional CSS code used to customize the code field.

Multiple¶

The Multiple group contains the following controllers:

Combobox
Values autocomplete
Radio buttons
General item list

Their layout can be customized by right-clicking onto the component and clicking Open widget layout. Browse the tabs below to know more about the available options for each Multiple controller.

COMBOBOX

Option	Description
Label	The label of the combobox.
Label width	The width (in pixels) of the label.
Combobox width	The width (in pixels) of the combobox in the mask.
Option	Select from the drop-down list the option, among those which have been previously set in the Options tab, which will be linked to the combobox.
Order	The position of the controller in the mask. It is a 0-based dictionary, and its default value is 0 for all components, meaning that the order of the components will follow the dragging order. If this value is specified, controllers will be sorted in ascending order according to the Order value.
Css	Additional CSS code used to customize the combobox.
Add undefined value
Add null value
Values

VALUES AUTOCOMPLETE

Option	Description
Label	The label of the values autocomplete controller.
Label width	The width (in pixels) of the label.
Combobox width	The width (in pixels) of the values autocomplete.
Option	Select from the drop-down list the option, among those which have been previously set in the Options tab, which will be linked to the values autocomplete.
Order	The position of the controller in the mask. It is a 0-based dictionary, and its default value is 0 for all components, meaning that the order of the components will follow the dragging order. If this value is specified, controllers will be sorted in ascending order according to the Order value.
Css	Additional CSS code used to customize the values autocomplete.
Values

RADIO BUTTONS

Option	Description
Label	The label of the radio button.
Label position	The position of the label. The possible values are: Start (default), Top, Bottom, End.
Label width	The width (in pixels) of the radio button.
Group direction	The direction of the options in the radio button. The possible values are: Row (default), Column.
Option height	The height of the options.
Option	Select from the drop-down list the option, among those which have been previously set in the Options tab, which will be linked to the radio button.
Order	The position of the controller in the mask. It is a 0-based dictionary, and its default value is 0 for all components, meaning that the order of the components will follow the dragging order. If this value is specified, controllers will be sorted in ascending order according to the Order value.
Css	Additional CSS code used to customize the radio button.
Add other	If selected, the Other field, where users can specify a custom value, is added to the mask.
Values

GENERAL ITEM LIST

Option	Description
Label	The label of the list.
Option width	The width (in percentage) of the list.
Option	Select from the drop-down list the option, among those which have been previously set in the Options tab, which will be linked to the list.
Order	The position of the controller in the mask. It is a 0-based dictionary, and its default value is 0 for all components, meaning that the order of the components will follow the dragging order. If this value is specified, controllers will be sorted in ascending order according to the Order value.
Css	Additional CSS code used to customize the list.
Items