Progress
AppBuilder
Developer’s Guide
Configuring SmartFrame Visual Properties
SmartFrames are based on the Frame widget. To open the property sheet for the Frame widget component, double-click the client area of the SmartFrame, or choose Tools
Property Sheet. The dialog box shown in Figure 3–5 will open.
Figure 3–5: SmartFrame Property Sheet
![]()
Minimal Configuration Changes
Although you can choose to accept many default settings, you should at least ensure that each SmartFrame instance you create is uniquely identifiable. To individualize a SmartFrame, make these changes:
- Replace the generic instance identifier with one that more closely describes the Frame instance you are creating. The instance identifier is the token that will appear in the source code, and is the default value for the filename. Note that Progress identifiers for Frame objects are conventionally prefixed with an f.
- If your new Frame will have a visible title bar, change the generic text to a string that identifies the purpose of the Frame.
Miscellaneous Properties (Other Settings)
You can make a number of changes to a Frame’s appearance and behavior, if the default settings do not suit your purposes. Some properties are discussed in the sections on SmartWindows and SmartDialogs. Listed here are the properties unique to Frames:
- Down — Normally cleared. Setting this box allows as many frame iterations (logical lines of output) as will fit to be written to the Frame before pausing. This option has no meaning if the Frame is not being used for direct output.
- No Box — Normally set. Clearing this option causes the Frame to display with a visible border.
- Title Bar — Normally cleared. Setting this box clears the No Box option and causes the Frame to display with a border and a prominent, visible title bar. You can set the background and foreground colors of the title bar (choose the Title Bar Color button), though the settings have no effect when the application is running under MS-Windows.
Advanced Properties
You can make several changes to a Frame’s behavior or appearance in the Advanced Properties dialog box. To open the dialog box, shown in Figure 3–6, choose the Advanced button.
Figure 3–6: SmartFrame Advanced Properties Dialog Box
![]()
Some properties are discussed in the sections on SmartWindows and SmartDialogs. Listed here are the properties unique to Frames:
- {&FRAME-NAME} — Normally cleared.
- Manual Highlight — Normally cleared. Setting this box allows you to use special highlighting for certain objects.
- Movable — Normally cleared. Setting this box allows the user to move the Frame within the enclosing space (Window, Dialog, or other Frame).
- Page Top, Page Bottom — Normally cleared.
- Resizable — Normally cleared. Setting both this box and the Selectable box allows the user to resize the Frame, within the boundaries of the enclosing object.
- Selectable — Normally cleared. Setting this box allows the user to select and, if Resizable is also set, resize the Frame.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |