Skip to content

Form Group

A form group puts a label, an input and a message in one tidy unit. Use it for every field of a data entry form, so labels and inputs line up and validation messages have a place to appear.

Parts

A form group has three parts:

Part What it holds
Label The text that names the field.
Input The control the user types in: a Text Box, a Dropdown, a Date/Time Picker, or another input.
Description A hint, or the validation message for the field.

Properties

Property Description
Has Label Container Shows the label part.
Has Description Container Shows the part for hints and validation messages.
Horizontal Align Places the label and the input side by side, instead of one above the other.

Example

A Name field:

  1. Drag a Form Group onto the form.
  2. Put a Label with the caption Name in the label part.
  3. Put a Text Box bound to Product.Name in the input part.
  4. Mark the text box Required. If the user leaves it empty, the message appears in the description part.

Tips

  • Studio's Data Entry forms create one form group for each attribute of a class.
  • Use a Layout to put several form groups in columns.

In Studio

A form group with its label and an unbound text box, and its properties: Horizontal Align, Has Label Container (on by default), Has Description Container and the events.

The Form Group and its properties