In your web screens you can present a list of possible values and the end-user can select multiple values from the presented list. This behavior is implemented by the List Box widget.

This widget is populated using the List of records in the Source Record List property. The record definition must have a boolean attribute to hold the end-user selection; this attribute must correspond to the Selection Attribute property of this widget.

The values presented to the end-user in the list box are the ones that come from the attribute in Source Attribute property.

You can specify whether the end-user can select multiple values, which is the default, or just one single value. This behavior is implemented by the Selection Mode property. How?

To select multiple values, the end-user simply has to press the CTRL key and then select the values.

Handling the end-user's selection

Once the values selected by the end-user are submitted, you can access them through the List runtime property of the List Box widget. This runtime property contains a copy of the Source Record List used to populate the widget but with the end-user choice reflected in the Selection Attribute.

If you want to select by default some of the values, simply set to TRUE the Selection Attribute of those records in the Source Record List supplied list.

When a screen action terminates with an End element, you must explicitly copy the List runtime property to the Source Record List of the widget in the screen preparation. This must be done to preserve the end-user selections, which are lost otherwise.

This widget has Ajax capabilities. Learn more About Rich Web Screens using Ajax.

See Also

Layout of Widgets | List Box Widget Properties | List Box Widget Runtime Properties | Apply Web Styles