skip to main content
OpenEdge Development: AppBuilder
Organizer Objects : SmartFrames
 
SmartFrames
SmartFrames are special‑purpose organizer objects. They are members of the SmartContainer class and can integrate other SmartObjects.
Every SmartFrame must be supported by a SmartWindow or SmartDialog; they are not independent or outer‑level objects. The principal benefit SmartFrames offer is reusability. If you have a self‑contained layout that includes SmartObjects, and will be reused repeatedly but would not be appropriate to implement as a SmartDialog, consider implementing it on a SmartFrame.
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 ToolsProperty Sheet to display the frame’s 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 OpenEdge 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 (click Title Bar Color), 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:
Some properties are discussed in the sections on SmartWindows and SmartDialogs. The following 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.
Configuring SmartFrame procedure settings
The SmartFrame uses the standard Procedure Settings dialogs. See the “Procedure settings” section and the “Advanced procedure settings” section for more information.