The next table presents the properties of the Radio Button widget.

Property

Description

Optionality

Default value

Obs.

Name

Name of the widget used in the screen scope.

Optional

 

Although optional, only named widgets are available in the scope of the web 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 type of the Variable can be neither Binary Data, Object, Record, nor List.

Validation Parent

 

Allows you to bind a Radio Button widget to an 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 Radio Button widget is directly dragged into, for example, the EditRecord1 widget, this property will be set by default to EditRecord1.

In any other case it's empty by default.

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

Value

Value placed in the variable when selecting this specific widget.

You can type the value directly or use the Expression editor.

Mandatory

 

Must be of the same type as the Variable property. Otherwise an error message is presented and the eSpace is not valid.

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 radio button.

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 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 to the <input type = "radio"> 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.

NA

 

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

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

See Also

About Radio Button