Grid - Fields Grouping
This feature allows to group two or more fields into a virtual field of the special type Field Grouping.
Fields Grouping example
General Settings
See below the option’s general configuration for fields grouping.
Data Type
Informs the data type of the field in the application.
Label
Defines the title displayed in the application column.
The text definition has no character restriction and can be done with a fixed text or using a lang, to create systems with multiple languages.
See more details about langs and about our Data dictionary.
Grouping fields
In this attribute we define the fields that will be grouped, moving them to the right, and the order in which these fields will be displayed on the grouping fields.
Display options
Defines how grouped field values will be display in the field.
When selecting the option Label and Value (Default value) defines that both the label and the field value will be displayed, see the example below.
When selecting the Value option, only the field value will be displayed, see the example below.
Label positioning
- Above - Default value, positions the label of the grouped fields above the values.
- Beside - Positions the label of the grouped fields beside the values.
This attribute is only available when selecting the field value option in the Display Options attribute.
Example of above label
Example of beside label
Spacing beteween fields
Sets the spacing between grouped fields. This attribute is applied in pixels, for this definition we must inform only the numerical value.
Examples of fields with and without spacing
Title for sorting grouped fields
This attribute defines the title of the grouping sort box.
By default, Scriptcase defines the lang
{lang_field_grouping_choose_column_sorting}as the title. The lang text can be changed in the tool Application Language.
Example of sorting grouped fields
SQL type
Defines the SQL type of the field.
Display Settings
See below the options to display settings of the field grouping.
Title horizontal Alignment
In this attribute you can set the horizontal alignment of the field grouping title as: Left, Right or Centered
When leaving this value unchanged, the alignment assumes the configuration of the application’s theme.
Examples of horizontal alignments: Left - Right - Centered
Title vertical alignment
In this attribute you can set the vertical alignment of the field grouping title as: Top, Middle or Bottom
Examples of vertical alignments: Top - Middle - Bottom
Backgroud color
Defines the background color of the entire column of the grouping of fields.
The configuration of grouped fields must be carried out individually in the field.
Title color
Set a color to field grouping title overriding theme settings.
Example of label text color
Field title backgroud color
Set a background color to field grouping title overriding theme settings.
Example of the background color of the label
Bold
Defines whether or not the button group title will be in bold.