Progress
AppBuilder
Developer’s Guide
Configuring a Toggle–Box Instance
You can change some basic characteristics of the Toggle–Box widget’s appearance and behavior through its property sheet, if the default settings do not meet your needs.
To configure your Toggle–Box object, begin by selecting it and choosing Tools
Property Sheet. The dialog box opens:
![]()
Minimal Configuration
Although you can accept other default settings, you should make at least three changes:
- Object — Change the object identifier to one that better reflects the role of this Toggle Box in your application.
- Label — Change the label to a string that will help the user of your application understand what the Toggle Box selects.
Note that it will be better for your users if you do not create cross-connections in their heads: the cleared state should always represent the not/off/false/negative condition, not the default condition. Initialize the box to whatever the default condition is, whether set or cleared.
- Initial Value — By default, the Toggle Box initializes itself to the cleared state. To change that, click the Advanced button, and when the Advanced Properties dialog box opens, type yes into the Initial Value field.
Help
You can offer additional help to your users via these properties:
Geometry
Reflects the XY origin and size, in character units, of the object’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 changes you can make to the Toggle Box’s appearance and behavior if the default settings do not meet your needs:
- Auto-resize — Normally cleared. Setting this box causes the Toggle Box to automatically resize itself as needed.
- Display — Normally set. Clearing this box prevents the Toggle Box from automatically revealing its initial value. Note however that it always appears to have an initial value.
- Drop Target — Normally cleared. Setting this box causes the Toggle Box to experience an event whenever the user drops another object onto it. You would have to write the code to handle the event and deal with the object dropped.
- Enable — Normally set. Clearing this box prevents the Toggle Box from accepting the input focus when offered. This would mean the user could not change the Box’s value.
- Hidden — Normally cleared. Setting this box prevents the Toggle Box from responding to implicit requests to show itself. You would have to include code to explicitly request the object to appear.
- No Tab Stop — Normally cleared. Setting this box removes the Toggle Box from the enclosing Frame’s traversal list. An object not in the traversal list can neither gain nor lose focus when the user presses the TAB key. This can confuse users.
- No Undo — Normally set. Clearing this box causes the Toggle Box to journal all user changes to its value.
- Remove from Layout — Cleared. Cannot be set except when defining an alternate layout.
- Shared — Normally cleared. Setting this box makes the widget and its variable available to other procedures.
Advanced Properties
A Toggle–Box 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 |