skip to main content
OpenEdge Development: AppBuilder
AppBuilder Interface : Menu bar
Menu bar
The menu bar provides access to nearly all the AppBuilder functionality, apart from the component objects. Note that some menu options are not available when you are working in WebSpeed development mode.
File menu
The File menu allows you to create, open, save, and print procedure files.
Opens the New dialog box. After you choose the object or component you want to create, AppBuilder reads in the appropriate template. A template is an incomplete procedure file for an object. After loading the template, AppBuilder will take some further, template‑specific action:
*Windows, dialog boxes, and outer‑level frames: AppBuilder opens a design window or workspace where you assemble and arrange the widgets that will make up your application’s user interface. AppBuilder also opens a workspace if you choose Simple SmartObject, since the majority of SmartObjects will have a visible representation.
When designing WebSpeed applications, you do not work with a design window. See OpenEdge Getting Started: WebSpeed Essentials tutorial for an overview.
*SmartObjects based on a master: AppBuilder starts the design wizard for that class of object. After the design wizard runs to completion, you will have a fully defined SmartObject master that you will normally save to disk.
*Procedure, include file, or methods library: AppBuilder opens two windows. One shows a tree view of the editable sections of that file type, and the other displays the built-in source‑code section editor with a code stub for the current section type.
Opens an existing object file and displays its associated design window or tree view. If AppBuilder cannot determine how to present the file in a better way, it will use a procedure window.
You can also drag and drop a file from the Windows Explorer or desktop to the AppBuilder main window. AppBuilder opens the file according to type, and prompts you to connect to any necessary databases.
Saves the current procedure file locally or remotely, according to your current development mode. AppBuilder prompts you for a filename only if you have not saved this file before.
FileSave As
Opens the Save As dialog box for the current procedure file. Normally you would Save As in order to change the filename, but you can Save As to the original filename if you wish.
FileSave All
Immediately performs a save on all open files being maintained by AppBuilder.
Newly‑created files are saved locally or remotely according to the Development Mode setting. Previously‑existing files are saved to the locations from which they were opened, regardless of the Development Mode setting.
Caution: You must perform individual saves on any files that AppBuilder opens in a Procedure Editor window rather than a Section Editor. Use of the Procedure Editor means that AppBuilder does not maintain the file.
Prints the source code of the current structured‑procedure file, not the currently selected object specifically. If you clear the Use Print Dialog Box option in the Preferences dialog box, the file is printed to the default printer immediately, without further prompting.
Edit menu
The Edit menu allows you to perform a number of coarse‑grain, generic editing operations such as cutting and pasting.
Shortcut: CTRL+Z — Undoes the most recent operation, including a Delete, if possible. The menu item text shows what that operation was. Item temporarily changes to Redo after an Undo. If undoing the most recent operation is not possible, this item is greyed out.
Shortcut: CTRL+X — Cuts the currently selected object, if any, to the clipboard.
Shortcut: CTRL+C — Copies the currently selected object, if any, to the clipboard.
Shortcut: CTRL+V — Pastes a copy of the current clipboard contents to the current workspace, at the current cursor position.
Creates a copy of the currently selected object without using the Clipboard. The new copy is pasted directly on top of the original. To see the original, the duplicate must first be moved out of the way.
Removes the currently selected object, if any. You can recover a deleted object if you can Undo the operation, but you cannot recover by pasting because the Clipboard is not involved.
EditCopy to FIle
Opens a dialog box to copy the source code for the currently selected object to an export (.wx) file.
EditInsert from File
Opens a dialog box to insert the contents of some file into the procedure editor at the current insertion point.
EditTab Order
Only enabled when a frame is selected, this item opens the editor that allows you to define the TAB traversal order for objects in the frame. The editor offers five predefined orderings plus a custom ordering that you can define on a per‑frame basis.
EditGoto Page
Only enabled when editing a SmartContainer. Opens the dialog box that lets you set the ADM Design Page. See the “Simple SmartContainers” section for information about the meaning of the Design Page.
EditAssign Widget IDs
Only enabled when editing a SmartContainer. Writes Widget IDs to all frames and widgets of the currently selected container. This overwrites any existing Widget IDs. Widget IDs are used to identify the widget at runtime while testing your OpenEdge GUI application with a third-party automated test tool.
Compile menu
The Compile menu allows you to invoke the AVM to inspect, test, and debug your work.
Shortcut: F2 — Compiles and runs the current workspace. While the workspace is running, no AppBuilder control is available other than the Stop button, which appears in place of the Run button in the toolbar.
CompileCheck Syntax
Shortcut: SHIFT‑F2 — Does a syntax check on the current workspace without running it.
Shortcut: SHIFT‑F4 — Compiles the current workspace and starts the Application Debugger.
CompileCode Preview
Shortcut: F5 — Opens a source‑code viewer on the currently selected SmartObject master. If the currently selected SmartObject is an instance rather than a master, the viewer window will instead display the source of the current container object (workspace).
CompileClose Character Run Window
Closes the currently open character‑mode test window, if any.
Tools menu
The Tools menu gives you access to several of the important AppBuilder dialog boxes as well as the other OpenEdge tools installed on your system.
ToolsNew Procedure Window
Shortcut: CTRL+F3 — Opens a version of the Procedure Editor, with a reduced number of menu items. The Procedure Editor is not AppBuilder’s built-in Section Editor, and should not be used to edit files that were created by AppBuilder. (Note that the behavior of this editor may be slightly different to that of the basic Procedure Editor—the two do not use the same underlying code.)
ToolsNew ADM Class
Opens a dialog box to allow basic definition of a new class, generating all the relevant files. Entering the class name automatically fills in the blanks for the other fields.
ToolsTEMP-DB Maintenance Tool
Opens a tool for managing the TEMP-DB database and associated temp-table include files. See the “The TEMP-DB database” section for more information.
ToolsProperty Sheet
Opens the appropriate base properties dialog box for the current object.
ToolsProcedure Settings
Opens the file level properties dialog box for the current procedure file. Procedure settings include:
*The type of procedure file
*The filename
*The description
*The location of the properties for ActiveX objects, if any, in this context
*The directory in which AppBuilder compiles the procedure file
*The external tables (if any) required for the procedure file
*The settings for running from AppBuilder
*The custom lists available for the procedure file
*The relevant information about partition and pages, if the file represents a SmartObject
Additionally, if you open a template, you can access the template’s advanced procedure settings. These settings determine, among other things, what types of objects you can place in a design window. For more information, see the “Procedure settings” section.
Opens the color selector for the current object. Not available in Remote (WebSpeed) mode.
ToolsDatabase Connections
Opens a window to display, add to, or remove current database connections.
Options menu
The Options menu allows you to set both general and editor‑specific preference items, and change the visibility and magnetism of the layout grid.
Opens the dialog box that allows you to set various preferences. See the “Setting your preferences” section for detailed information.
OptionsEditing Options
Opens the dialog box that allows you to set editing‑environment preferences such as color‑coding, tab size, etc. See the “Setting your preferences” section for detailed information.
OptionsSnap to Grid
Determines whether objects will snap to the nearest gridlines in frames. The gridlines need not be visible. This switch affects all layout workspaces, not just the current one.
OptionsDisplay Grid
Determines whether layout gridlines will be visible. This switch affects all layout workspaces, not just the current one.
Layout menu
The Layout menu allows you to define additional layouts and to arrange selected objects in regular ways.
LayoutAlternate Layout
Opens the Alternate Layout dialog box. You can define the conditions for additional layouts using this dialog box. For more information, see Appendix B, “Multiple Layouts”.
LayoutCenter Left‑to‑Right in Frame
LayoutCenter Top‑to‑Bottom in Frame
Centers all selected objects along one axis (X or Y) within the frame, without changing their positions on the other axis.
LayoutEven Spacing Left‑to‑right
LayoutEven Spacing Top‑to‑Bottom
Evenly spaces the objects from one another along one axis (X or Y) without changing the overall space they take up, and without changing their positions on the other axis.
Changes the Z-axis layering order of the selected object. Moving it to the top makes it seem to overlay all other objects (that is, it makes the object seem closest to the viewer); moving it to the bottom makes it seem to be overlaid by all other objects (makes it seem furthest away). Some objects do not respond to relayering requests.
Opens a submenu where you can choose the feature on which to align multiple objects. Objects can be aligned in the following ways:
*By label colons.
*By left or right edges, or horizontal center (vertical centerline).
*By top or bottom edges, or vertical center (horizontal centerline).
Window menu
The Window menu provides access to the built-in Section Editor, the common properties editor window, the OCX properties editor, and a list of current objects.
WindowCode Section Editor
Shortcut: CTRL+S — Invokes the built-in source‑code editor on the current object. Unlike other editors, including the standard Procedure Editor, the built-in Section Editor will not make object source code unmanageable by AppBuilder.
WindowHide Object Palette
Determines whether the Object Palette is visible. The menu item changes to Show Object Palette when the Object Palette is hidden.
WindowProperties Window
Opens the window that lists certain of the common properties of all selected objects. For example, all objects have an origin and a size. Where property values differ between objects, as is typically the case, the differences are represented by a range in the Properties window. You can set substitute a single value for the range, and this will affect all selected objects.
WindowOCX Property Editor
If the current object is an ActiveX object, opens an editor window for the object’s properties. If the current object is not an ActiveX object, selecting this item opens a window with no content.
Help menu
The Help menu provides access to useful information of various kinds.
HelpOpenEdge Master Help
Opens the master online help system for the OpenEdge Application Development Environment.
HelpAppBuilder Help Topics
Opens the online help system for the AppBuilder.
Opens a window that displays the text associated with the message number you enter.
HelpRecent Messages
Opens a window that allows you to review recent messages that AppBuilder generated, if any.
HelpCue Cards
Opens a window that displays recently dismissed cue cards, if any.
HelpAbout AppBuilder
Opens a window that displays the version of AppBuilder you are running, the current version of the operating system, and the total and free hardware memory.
Tool bar
Most buttons on the tool bar correspond to menu options. The exceptions are the List Objects button, and the Development Mode switch. The Development Mode switch is a special option not present in all versions of AppBuilder. See Figure 10.
Figure 10: AppBuilder tool bar
You can use the Windows Tooltip feature to view the action labels for each button. For a more complete description of the button’s function, see the description for the corresponding menu item, as noted.
Click on the tool bar buttons to invoke the following AppBuilder actions:
*New — Corresponds to FileNew.
*Open — Corresponds to FileOpen.
*Save — Corresponds to FileSave.
*Print — Corresponds to FilePrint.
*Procedure Settings — Corresponds to ToolsProcedure Settings.
*Run — Corresponds to CompileRun.
*Edit Code — Corresponds to WindowCode Section Editor.
*List Objects — Invokes the List Objects dialog box, which lists all the objects in use in the AppBuilder session, allowing you to access their Property Sheets. There is no other way to open this dialog box.
*Object Properties — Corresponds to ToolsProperty Sheet.
*Colors — Corresponds to ToolsColor.
*Development Mode Switch — If present, alternates the development mode between local and remote. These modes affect where AppBuilder compiles, runs, and saves objects. For more information on using remote (WebSpeed) development mode, see OpenEdge Getting Started: WebSpeed Essentials.