Modeled dialog fields can be grouped by using the attribute "UI Category". The attribute can be found among the tool descriptor and filter type attributes. The group will be visualized in the dialog by a frame around the dialog fields which has a label at the top. If several dialog fields share a UI category value, they will be grouped within the frame.
By default a UI category has one column which means that all dialog fields of this category are placed underneath each other. Increasing the column number of a category will result in dialog fields being displayed next to each other.
The syntax for the UI category attribute is:
Category Name/<number of columns>,<column span>/
The following syntax is also valid but deprecated:
Category Name{<number of columns>,<column span>}
Since the number of columns and the column span are optional attributes with the default value of "one" they do not need to be specified if not required (see the table below).
| UI_Category value | Result |
|---|---|
| Field 1: Example Category | A framed group with the label “Example Category” and one column. The two fields will be displayed underneath each other. |
| Field 1: Example Category | Two framed groups with the labels “Example Category” and “Another Category” will be created underneath each other. The first category will contain two dialog fields while the second category will only contain one field. |
| Field 1: Example Category/2/ | A framed group with the label “Example Category” and two columns. The four fields will be displayed in two rows. |
| Field 1: Example Category/2,2/ | A framed group with the label “Example Category” and two columns and rows. The first field will fill up the first row (since it spans both columns) while the second row will contain Field 2 and 3. |
| Field 1: (space character) | One invisible category will be created for each field. The visible effect will be that the two fields use the full width of the dialog instead of being shifted behind the longest label of other dialog fields. |