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

Property

Description

Optionality

Default value

Obs.

Name

Name of the widget used in the screen scope.

Mandatory

ListBoxn

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

See rules for naming elements.

Validation Parent

Allows you to bind a List 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 List Box 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 List Box widget inside the Edit Record widget, in the screen Scope Tree.

Source Record List

List variable used to populate the widget when the screen is rendered.

Mandatory

 

When this property has the value Single, the List Box widget behaves like the Combo Box widget.

Source Attribute

Name of an attribute of the source record, specified in the Source Record List property. This attribute corresponds to the values displayed to the end-user.

Mandatory

 

This attribute must be set, otherwise an error is displayed and the eSpace is not valid.

Selection Mode

Allows you to specify whether the end-user can select more than one value or just one. The possible values are: multiple and single.

Mandatory

Multiple

 

 

Selection Attribute

Name of the attribute of the source record, specified in the Source Record List property, which will hold the end-user selection of each row: when the end-user selects a value, the corresponding record has the Selection Attribute set to TRUE; otherwise, it's set to FALSE.

Mandatory

 

This attribute must be of type boolean, otherwise an error is displayed and the eSpace is not valid.

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

3 col

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

Height

Visual height, in the measure specified, of the widget.

 

 

The possible measures for this widget are: pixels and percentage. The percentage  is relative to the screen or table where the widget is inserted.

The default units are pixels.

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.

Style

Drop-down list with the styles that can be applied to the list 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 select one or more values from the list of values. When this property is set to false, the end-user can see but cannot select one of these values.

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 <select multiple = "multiple"> 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 <select multiple = "multiple"> 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 <select multiple = "multiple"> HTML tag that corresponds to this widget.

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

See Also

About List Box Widget