Progress
AppBuilder
Developer’s Guide
Configuring a Selection–List Instance
To configure your Selection–List object, begin by selecting it and choosing Tools
Property Sheet. The dialog box opens:
![]()
Minimal Configuration
Although you can accept many default settings, you should make at least these changes:
- Object — Change the object identifier to one that more clearly relates to the role of this List object in your application.
- Items versus 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.
Help
You can provide your users additional help through these settings:
Geometry
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.
Miscellaneous Properties (Other Settings)
There are a number of other changes you can make to the Selection List’s appearance and behavior, if the default settings do not meet your needs:
- Auto-resize — Normally cleared. Setting this box causes the Selection List to change its dimensions to keep the same number of list items in view when, for example, the font changes.
- Display — Normally set. Clearing this box prevents the Selection List from automatically displaying its content items during initialization.
- Drag-enabled — Normally set. Clearing this box prevents the user from being able to select a number of consecutive lines by holding down the SHIFT key and dragging the mouse pointer down the list.
- Drop Target — Normally cleared. Setting this item causes the Selection List to experience an event whenever the user drops another object onto it. You would have to write code to handle the event and deal with the object dropped.
- Enable — Normally set. Clearing this box prevents the Selection List from accepting the input focus when offered. Without the input focus, the user cannot select a listed item.
- Hidden — Normally cleared. Setting this box prevents the object from responding to implicit requests to display itself. You must include code to explicitly paint the object, when this box is set.
- Multiple Selection — Normally cleared. Setting this box allows the user to select more than one listed item.
- No Tab Stop — Normally cleared. Setting this box removes the object from the parent Frame’s traversal list. An object not in a traversal list can neither gain nor lose focus when the user presses the TAB key. If the object has focus, it keeps it. If it does not have it, focus circulates among only the objects that are in the traversal list, bypassing the excluded object.
- No Undo — Normally set. Clearing this box causes changes to be journaled.
- Remove from Layout — Cleared. Cannot be set unless working on an alternate layout.
- Scrollbar Horizontal/Vertical — Normally Vertical only. Set or clear to change the kind of scroll bar(s) the object displays.
- Shared — Normally cleared. Setting this box makes the Selection List’s contents and variable available to procedures other than the one in which you defined the object.
- Sort — Normally cleared. Setting this box presents the listed items to the user in sorted order.
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 in "Frequently Used Dialogs," for more information.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |