The VPM Enterprise PageFrame Builder is a builder that automates the placement of pageframes on a form based on any form class. Use this builder when you need to create a form that contains data in a pageframe.
Tip on Sizing: The size of the page frame that the PageFrame Builder builds for you is based on the size of your form when you run the builder. Therefore, size your form appropriately before you run the PageFrame Builder.
When you run the builder, you have three choices for how the pageframe is sized and placed on the form:
· You can choose to have the pageframe fill the entire form.
· You can choose to have the pageframe placed on the top half of the form.
· You can choose to have the pageframe placed on the bottom half of the form.
Of course, after the builder places a pageframe on a form, you can resize the pageframe and move it as you like.
You can use the PageFrame Builder to place as many pageframes on a form as you need.
The following steps show you how to use the ProMatrix PageFrame Builder to place a pageframe on a form.
Ř To build a pageframe on a form
Opening the Form Editor: The steps below assume that you already have opened the Form Editor for the new form you are creating. You can open a Form Editor for a new form by adding a menu option or through the Called Objects list of another Object Editor. If you need help with opening the Form Editor for a new form, see How to Begin Creating a New Application Object.
1. New Form Dialog, Change the Form Class and Set Up the Data Environment and Form Properties
First, complete the same steps 1, 2 and 3 required to create a form with the ProMatrix Basic Form Builder. See ProMatrix Basic Form Builder.
These steps involve:
· Selecting whether to start with (a) a blank form based on a form class that you specify, (b) a blank form based on the default form class template or (c) a copy of an existing form.
· Changing the form class to the class you want in the Form Designer if it is not already selected.
Tip: You can use any form class with the ProMatrix PageFrame Builder.
· Setting up the data environment and form properties for your form.
2. Run the ProMatrix PageFrame Builder
1. Size the form to the size it will need to be to contain the data that you will be adding to the pages in the pageframe. After running the PageFrame Builder, you can always resize the form and the pageframe as needed.
2. Right click on the form and select Builder from the popup menu.
3. Select ProMatrix PageFrame Builder from the Builder Selection dialog. VPM Enterprise displays the ProMatrix PageFrame Builder.
3. On the ProMatrix PageFrame Builder enter/select the following items:
· Form Name: Enter a unique name not used on any other form in the application. (If you are adding an additional pageframe to a form, you have probably already done this, and the form name you selected previously will be displayed in the Form Name field.)
· Form Caption: Enter the caption that you want to display in the form's title bar. (If you are adding an additional pageframe to a form, you have probably already done this, and the form caption you selected previously will be displayed in the Form Caption field.)
3. Set Up the Pageframe Page(s)
1. Select the Number of Pages: By default, the PageFrame Builder adds one page to the pageframe. Click the Add Page button at the bottom of the builder to add additional pages.
If you add a page you don't want, you can remove it by selecting the page and clicking the Remove Page button.
2. Set Up Each Page: Select each page and set up the data to be displayed on the page as described below:
· Page Caption: Enter a caption for the page.
· Select Fields: The ProMatrix PageFrame Builder shows the fields from all of the tables, views and CursorAdapters you have added to the Data Environment. The table, view or CursorAdapter alias is shown with the fields. Move the fields you want on the page from the Unselected Fields list to the Selected Fields list.
· Order Fields: The fields in the Selected Fields list will be placed on the page in the order in which they are listed. Therefore, change the order of the fields so that the order meets your specifications.
3. Selected Field Properties: When you highlight a field in the Selected Fields list, the Selected Field Properties box shows:
· Label: This is the field Description (Long) property entry from the Data Builder. The Form Builder will put the Label entry on the page.
Tip: After the form is built, you can change a label on a page to something other than the field label text in the Data Builder. To do this, select the label, change it's Caption property to the text you want, and then change the label’s lOverrideCaption property to .T..
· Control Type: The default VPM Enterprise control class that will be used to put the field on the page. You can change the control class via this Control Type combo box. For example, by default VPM Enterprise puts a numeric field on a form using the TextBox class. You can change the class to the Spinner class through the Control Type combo box.
Tip – Picklist Help: If a field is a foreign key using Referential or Set validation, choose a VPME textbox or combobox control for the field and later set up the control properties to get the Picklist behavior you want.
· Read-Only: If you want to make the field read-only, check this box.
4. Repeat Steps 2 to 3 for each page.
5. Select Page Placement and Size: Click the combo box at the bottom of the builder to select where and at what size the builder should place the pageframe on the form. Your choices are:
· Entire Form: the pageframe will fill up the entire form.
· Top Half: the pageframe will fill up the top half of the form.
· Bottom Half: the pageframe will fill up the bottom half of the form.
4. Build Form
After you have set up the pages as you want them, click the Build PageFrame button. The ProMatrix PageFrame Builder will build the form for you.
5. Clean Up
After the PageFrame Builder creates the form, you will want to clean it up. In particular, you may need to resize the form and the page frame to better fit the fields you added to the pageframe.