The next table presents the properties of the Form widget.

Property

Description

Optionality

Default value

Obs.

Name

Name of the widget used in the screen scope.

Mandatory

Formn

This name represents the widget in the Scope Tree where it aggregates its runtime properties.

See rules for naming elements.

Width

Indicates the width of the widget. You can change the width by editing this property or by resizing it using the Grid in the Content Canvas.

Optional

6 col

The value of this property can be in columns, pixels, points, or percentage.

Margin Left

Indicates the width of the left margin of the widget.

This value can be automatically set by the Grid.

Optional

Auto

The value of this property can be in pixels, points, or percentage.

If not defined and the widget style defines a margin-left then this margin is applied to the widget.

Margin Top

Indicates the height of the top margin of the widget.

This value can be automatically set by the Grid.

Optional

Auto

The value of this property can be in pixels or points.

If Auto is selected and the widget style defines a margin-top then this margin is applied to the widget.

Source Record

A copy of the source record will be created and stored in an implicit variable within the Form widget itself.

Mandatory

 

The Source Record variable is only copied once into the Form widget, after the screen Preparation finishes. Afterwards, when executing Screen Actions the values stored on the Source Record, will not be copied into the Form's implicit variable, ensuring the end-user input is never overwritten.

Label Position

The position of the Label widgets relative to the input widgets inside the form.

The possible values are: 'Above Input' places the labels above the inputs, 'Left Aligned' which places the labels before the input and aligned to the left, and 'Right Aligned' which places the labels before the inputs and aligned to the right.

Optional

Align Left

 

Style

Defines the CSS style applied to the widget.

Optional

Form

Learn more About Style Sheets.

A drop-down list of suggestions is shown to facilitate selecting a single style. To apply more than one style simply separate the styles with a blank space.

Double-click on the property and the Style Sheet Editor is opened with the current style already selected.

Enabled

Provides a quick way to disable all the inputs inside the Form. Setting this property to False as the same effect as setting the Enabled property of all the inputs to False.

Mandatory

True

Although setting this property to False disables the inputs, this does not prevent malicious tampering of this setting on the client side.

Therefore, you should always complement this setting with validation on server side to assess the end-user has the right privileges to edit this information.

Extended Properties - Additional properties for attributes and events that implement specific behaviors of your widget.

Name

Name of the attribute that the HTML element can accept as specified in the HTML language reference.

 

 

This property is added to the HTML tag that corresponds to this widget.

Learn more about Extending Properties and how widgets are translated into HTML tags.

Value

The value for the attribute.

 

 

This property is added to the HTML tag that corresponds to this widget.

Learn more about Extending Properties and how widgets are translated into HTML tags.

See Also

About the Form Widget | Form Widget Runtime Properties