Progress
AppBuilder
Developer’s Guide
Inserting Text-string Tokens from Lists
Database Field Names
To insert the name of a database field into an editing area, choose Insert
Database Fields from the Section Editor menu or choose the Section Editor’s pop-up menu by right-clicking in the editing area. The Field Selector dialog box appears, as shown in Figure 2–12.
Figure 2–12: Field Selector Dialog Box
![]()
This dialog box lets you choose any field for any currently connected database. Follow these steps to specify a database field:
- Select a database. The Tables and Fields lists change.
- Select a table. The Fields list changes again.
- Select the field names that you want to insert in the current editing area:
- Specify a prefix (qualifier) for the field name:
- Choose OK to insert the fields.
AppBuilder inserts the field names at the cursor location in the current editing area or replaces selected text.
Event Names
To insert event names in an editing area, choose Insert
Event Name. The Choose Event dialog box appears, as shown in Figure 2–13.
Figure 2–13: Choose Event Dialog Box
![]()
This dialog box displays a list of all events recognized by the Progress 4GL. To choose a listed event, select it and click on OK:
Procedure/Function Calls
To insert a call to an internal procedure or function or to a SUPER procedure’s internal procedure or function in an editing area, choose Insert
Procedure Call. The Insert Procedure Call dialog box appears, as shown in Figure 2–14.
Figure 2–14: Insert Procedure Call Dialog Box
![]()
Table 2–9 identifies and describes the options available on the Insert Procedure Call dialog box.
Use the Procedure Object drop-down list to select the appropriate ADM object. This allows you to call the procedures and functions for that super procedure. Figure 2–15 shows the procedures for
containr.p
.Figure 2–15: Listing Insertable Procedures
![]()
The Procedure Object field lists all of the procedure handles (THIS–PROCEDURE or SmartObject instances) referred to in the current procedure file. For a standard window procedure file, THIS–PROCEDURE is the only procedure handle. For a SmartContainer, each SmartObject instance has a handle that is listed, in addition to THIS–PROCEDURE, which is listed for the SmartContainer itself. When you choose a procedure handle in the Procedure Object field, all of the internal procedures or functions listed pertain to the procedure associated with the object.
NOTE: AppBuilder does not keep track of parameters needed for internal procedures in THIS–PROCEDURE. It does this only for procedures and functions in SmartObject instances used by THIS–PROCEDURE. If you insert a RUN statement for a procedure defined in THIS–PROCEDURE, you must either check to see if the correct parameters are passed or wait for the Progress Compiler to do so.Preprocessor Names
To insert Preprocessor names in an editing area, choose Insert
Preprocessor Name. The Preprocessor names are listed under its tab in the Code References window, as shown in Figure 2–16.
Figure 2–16: Preprocessor Names Dialog Box
![]()
To select a Preprocessor name, click on the name and choose OK. For more information about Preprocessor names, see the online help.
Queries
You can use AppBuilder’s query-building dialog boxes to generate a query definition rather than typing in the query. To do this, choose Insert
Query. The Query Builder dialog box appears, as shown in Figure 2–17.
Figure 2–17: Query Builder Dialog Box
![]()
This dialog box is the first in a series of dialog boxes that help you generate a query. For more information about building queries in AppBuilder, see the section "Defining and Editing Queries Using Query Builder" in Data-access Objects."
When you finish generating the query, choose OK. The Section Editor inserts the entire text of the query at the cursor location in the current editing area.
Object Names
To insert object names in the current editing area, choose Insert
Object Name. The Code References window appears, open to the Object Names tab, as shown in Figure 2–18.
Figure 2–18: Object Names Dialog Box
![]()
This dialog box displays the 4GL object names of all widgets and SmartObject instances available in the procedure file:
To insert an object, click on it and choose OK. To insert more than one, hold down the CTRL key while selecting. The Section Editor will insert your choice at the cursor.
Filenames
To insert a file’s pathname in the current editing area, choose Insert
File Name. The Choose Insert File Name dialog box appears, as shown in Figure 2–19.
Figure 2–19: Choose Insert File Name Dialog Box
NOTE: This is the same dialog box that appears when you wish to insert the contents of a file rather than only a filename. Make sure of what you are doingTo insert the file’s pathname, select the filename and choose OK. The Section Editor inserts the file’s pathname at the current cursor location in the editing area. By default, this dialog box displays all of the .i and .p files in the
src/template
directory.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |