skip to main content
OpenEdge Development: AppBuilder
Data-Display/Capture Objects : Selection lists
Selection lists
The selection-list widget allows you to present users with a list of values represented by text strings. Selection lists serve a similar function to radio button sets and combo boxes: grouping and presenting a set of potential choices. Unlike those objects, Selection lists permit multiple selection. Selection lists (or combo boxes) are more appropriate than radio-button sets when the number of items in the set cannot be determined in advance, or where long text strings are involved.
As with radio button sets, you can assign arbitrary values to the line items in the list.
Creating a selection list instance
Because the selection list widget is a basic ABL object, creating one is very simple.
To create the selection list widget:
1. Click Selection List in the Object Palette.
2. Move the mouse cursor over a bare spot in your workspace and click to place the new object.
3. Configure and size it.
Configuring a selection list instance
To configure your selection list object, begin by selecting it and choosing ToolsProperty Sheet. The Property Sheet dialog box appears:
Minimal configuration
Although you can accept many default settings, you should at least make the following changes:
*Object — Change the object identifier to one that more clearly relates to the role of this List object in your application.
*List-Items versus List-Item-Pairs — Choose whether the selection list object should interpret the content you enter in the field below as independent, listable strings only, or string + value pairs. If you elect Items, the value of the variable will the selected string(s) themselves. If you elect Pairs, the value will be the value portion of the selected item(s).
*Content — Type in the selectable items to be displayed by the object. They can be either strings (Items) or comma‑separated string + value pairs (Item Pairs). Type in only one item or item pair per line. If you are using Item Pairs, remember to separate the string from the value by a comma.
You can provide your users additional help through these settings:
*Tooltip — The selection list displays this string whenever the user allows the mouse cursor to hover over the object’s frame.
*Help ID — If you plan to provide context‑sensitive help, type in a unique integer identifier.
Reflects the XY origin and size, in character units, of the selection list’s bounding box. By default, the object’s origin is considered to be the upper‑left corner. You can elect to have AppBuilder consider the origin to be the upper‑right corner instead, though this will not change the object’s position in any way.
For more information on all the settings on the property sheet, see the online help.
Advanced properties
A selection list widget has only the standard advanced properties, but you can change those that do not meet your needs. See the “Advanced properties” section for more information.