The next table presents the properties of the Check Box widget.

Property

Description

Optionality

Default value

Obs.

Name

 

Name of the widget used in the screen scope.

Optional

When the widget is implicitly created by dragging an attribute or entity into an Edit Record, this property will be set by default to <entity_name>_<attribute_name>, for example Customer_Is_Active.

In any other case it's empty by default.

Although optional, only named widgets are available in the scope of the screen or web block. Only then can you use their runtime properties.

See rules for naming elements.

Variable

 

Variable that holds the end-user selection. This variable can be loaded with a default value set in the Preparation action.

You can type the name of the variable, use the Select Variable window or select one of the variables displayed.

Mandatory

 

The variable associated with this widget must be of type Boolean.

Validation Parent

 

Allows you to bind a Check Box widget to a specific Edit Record widget.

You can select the Edit Record from a drop-down list of the Edit Record widgets currently placed in the screen or screen block.

Optional

When the Check Box widget is directly dragged into, for example, the EditRecord1 widget or implicitly created by dragging an attribute or entity into EditRecord1, this property will be set by default to EditRecord1.

In any other case it's empty by default.

Specifying this property will place the Check Box widget inside the Edit Record widget, in the screen's Scope Tree.

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.

Style

Drop-down list with the styles that can be applied to the check box.

Optional

 

Learn more About Style Sheets.

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

Visible

When this property is false, the HTML page, generated at runtime, does not include the HTML tag that corresponds to this widget.

Mandatory

True

You can directly type the values true or false, select a variable that handles this (if the variable is not of type Boolean, an error message is presented and the eSpace is not valid), or use the Expression editor.

Enabled

Allows you to specify whether the end-user can edit the value of the variable associated with this widget. When this property is set to false, the end-user can see and select, but not change, the value of the variable.

You can directly type the values true or false, select a variable that handles this (if the variable is not of type Boolean, an error message is presented and the eSpace is not valid), or use the Expression editor.

Mandatory

True

If this property is false, the disabled attribute is added to the <input type = "checkbox"> HTML tag that corresponds to this widget. Learn more about how widgets are translated into HTML tags.

On Change - Grouped properties in the context of changing the value of the widget.

Destination

A list of possible screen actions created for the current screen is displayed sorted by name. Simply choose one of them.

Optional

 

The screen action will be called using Ajax. Learn more about rich web screens using Ajax.

Destination Arguments

The list of arguments that corresponds to the input parameters of the screen action. The values of the parameters must be of the same type as the input parameters.

NA

NA

The argument is mandatory or optional, if the parameter in the destination screen is respectively mandatory or optional.

Extended Properties - Additional properties for attributes and/or 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.

NA

 

This property is added in the <input type = "checkbox"> HTML tag that corresponds to this widget.

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

Value

The value for the attribute.

NA

 

This property is added in the <input type = "checkbox"> HTML tag that corresponds to this widget.

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

See Also

About Check Box Widget