Progress
AppBuilder
Developer’s Guide
Configuring a Pushbutton Instance
To configure a Pushbutton, you must:
To begin customizing the Pushbutton’s appearance, select it and choose Tools
Property Sheet. The dialog box opens:
![]()
Minimum Configuration
While you can accept many default settings, at a minimum you should:
- Change the object identifier to one that more closely represents the role of this Pushbutton in your application.
- Set the identifying label to a string or icon that will be meaningful to the user. See the "Setting a Pushbutton Label" section in this chapter for instructions.
- Resize the Pushbutton to fit it to its surroundings in a way that minimizes the space it takes up. For the best visual effect, you should make all related Pushbuttons the same size, and align them carefully. If one of them is more significant than the others, you can indicate that greater significance by making that Pushbutton unmistakably larger in one dimension, as in these examples:
![]()
Miscellaneous Configuration (Other Settings)
These properties modify appearance or behavior. Change settings that do not meet your needs:
- Auto-End Key — Normally cleared. Setting this box causes the ENDKEY condition when the user chooses the Pushbutton.
- Auto-Go — Normally cleared. Setting this box causes the GO condition when the user chooses the Pushbutton.
- Auto-Resize — Normally cleared. Setting this box causes the Pushbutton to automatically change size when its label changes size.
- Cancel Button — Normally cleared. Setting this box causes a CHOOSE event for this Pushbutton when the user presses the ESC key. In other words, when this box is set, pressing the ESC key and choosing this Pushbutton are equivalent actions. No matter which the user does, the CHOOSE trigger code you write executes.
- Convert 3D Colors — Normally set. Only relevant if you use an iconic rather than a text label for this Pushbutton. Clearing this box allows Progress to modify the colors used by the image you use as a label and use system colors instead. This might produce an undesirable visual effect.
- Default Button — Normally cleared. Setting this box causes this Pushbutton to receive all RETURN key function events, regardless of whether it is selected at the time. Note that, while AppBuilder allows you to set this option for only one Pushbutton per Frame—it clears any earlier setting—it cannot detect the same setting in other Frames.
- Default Style — Normally cleared. Setting this box adds the thicker margin around the Pushbutton that indicates to the user that the object receives the RETURN key events.
- Drop Target — Normally cleared. Setting this box causes the Pushbutton to register an event when the user drags an object onto it. You must write the code needed to handle the event.
- Enable — Normally set. Clearing this box causes the Pushbutton to ignore attempts to choose it.
- Flat — Normally cleared. Setting this box causes the Pushbutton to display its label without any border indicating the clickable area, except when the cursor is inside that boundary.
- Hidden — Normally cleared. Setting this box causes the Pushbutton not to respond to implicit requests to display itself. It will respond only to explicit requests.
- No Focus — Normally cleared. Setting this box causes the Pushbutton not to indicate that it has the input focus, although the user can select it in the normal way.
- No Tab Stop — Normally cleared. Setting this box removes the Pushbutton from the enclosing Frame’s traversal list. An object with this option set neither gains nor gives up the input focus in response to the user pressing the TAB key.
Advanced Properties
The Pushbutton object has only the standard Advanced Properties. See the "Advanced Properties" section in "Frequently Used Dialogs," for further information.
Setting a Pushbutton Label
You can choose to label your Pushbuttons with text or an iconic image, but you cannot use both on the same object.
To use a text label, simply type the new string into the Label field. You can even do this without opening the property sheet, if you wish. For your convenience, AppBuilder displays below the toolbar in its main window both the identifier and the label of a Pushbutton object whenever it is selected.
To use an icon (and override any text label), follow these steps:
- Double-click on the square button marked Up. The dialog box opens:
![]()
- If the image file you wish to use is listed. select it and choose OK. Note that if you set the Preview check box, the image you select will display in the open area to the right of the listing. Note, too, that if you are looking for a particular type of file (.ico, .bmp, etc.) you can choose to filter for only those files by selecting the appropriate item from the File Type drop-down list.
- If the image file is not listed, you can choose the Browse button to look for them. If you will often search certain other directories for image files, you can add the other directories to the drop-down list in the Directories combo box. Choose Edit Path to add a directory, or to modify the order in which they are listed.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |