Toolbar Controls

VPM Enterprise forms based on the Form_Toolbar class work with the VPM Enterprise Form Toolbar. The Form Toolbar allows your forms to maintain data for tables, views and CursorAdapters that contain more than one record. The VPM Enterprise Form Toolbar provides controls that let you view and manage the data in the tables, views and CursorAdapters.

VPM Enterprise toolbar controls let you navigate through the records, search for records, change the record order, add records, delete records and save changes to records.  The control buttons have pictures, or icons, that represent their functions.  The VPM Enterprise Form Toolbar controls are shown below.

 

 

The next two pages provide brief descriptions of each Form Toolbar control. The Find, Locate, Filter, Order, Group Delete and Print controls are described in more detail in following sections.

Edit Mode

You do not have to click an Edit button to enter an edit mode to change data on a standard VPME form. When a form is activated in VPM Enterprise, you may enter changes directly into the fields on the form. You click the Save button on the toolbar to save the changes. If you try to leave the current record without saving the changes, VPM Enterprise prompts you to choose whether the changes should be saved.

Toggle Controls

The Parent Mode and Filter buttons are toggles. As described in the table on the following pages, the pictures on these controls change to show whether the status of the control is On or Off.

Toolbar Menu Options

The Edit and View menus contain options for each Form Toolbar control. Toolbar controls that change data are on the Edit menu. Toolbar controls that help you navigate among data are on the View menu.

 

 

 

 

 

 

 

VPM Enterprise Toolbar Controls

Picture

Control

Purpose

 

Record Selection Controls:

The record selection controls allow you to choose the table, view or CursorAdapter records displayed and to set the display order.

Filter - Off

Brings up the VPM Enterprise Condition Builder for creating a record filter. When a filter is created, only records that satisfy the filter condition are displayed, and the Filter button toggles to the Filter On picture shown below. When the Filter Off picture is displayed, no record filter is in effect.

Filter - On

Turns filter off. When the Filter On picture is displayed, a record filter is in effect.

Order

Lists the table’s index tag descriptions for selecting the record display order.

 

Navigation Controls:

The navigation controls move through the records in a table, view or CursorAdapter and locate specific records.  As you navigate through the records in a table, view or CursorAdapter, the Order selected and the Filter in effect, if any, determine how the table, view or CursorAdapter appears to the navigation controls.

Find

Brings up the Standard Find Form or the SQL Find Form for finding a record. See Find Forms.

Locate

Brings up the Locate dialog for locating records using condition expressions created by the user. Displays all records meeting the conditions in a List grid for user selection.

List

Provides a picklist grid with incremental search and sortable columns for finding records quickly and easily.

First

Displays the first record in a table, view or CursorAdapter as defined by the record Order and Filter.

Prior

Displays the prior record in a table, view or CursorAdapter as defined by the record Order and Filter.

Next

Displays the next record in a table, view or CursorAdapter as defined by the record Order and Filter.

Last

Displays the last record in a table, view or CursorAdapter as defined by the record Order and Filter.

Print

Displays the VPM Enterprise Report Manager form. See Print to learn how to modify the Print Toolbar control.

 

VPM Enterprise Toolbar Controls

 

Control

Purpose

 

Data Update Controls:

You use data update controls to maintain the data in a table, view or CursorAdapter.  As you update the data, a record of the update is entered in the Audit Trail if the Audit Trail tool is on.

New

Displays blank form fields for adding a record to a table, view or CursorAdapter. If the record is added on a child form in a Related Forms situation or the record is added to a child cursor on a One-to-Many or Related Pages form, the primary key fields in the parent record are automatically entered into the foreign key fields of the new child record.

Copy

Copies the current record and displays the copy for editing.  Used to add a record and carry values from the current record to the new record.

Delete

Deletes the current record from the table, view or CursorAdapter.  Relational Integrity is enforced.

Group Delete

Brings up the Group Delete dialog for deleting records using condition expressions created by the user.  Deletes all records meeting the conditions entered.  As records are deleted, the Audit Trail is updated and Relational Integrity is enforced.

More

After entering a new record, clicking the More control saves the record and adds a new blank record.

Save

Saves data entered while adding, Copying or editing a record and ends the Add or Copy.

Cancel

Cancels data entries and changes made while Adding, Copying or editing a record and terminates the Add or Copy.

 

Related Forms Controls:

 

Parent Mode - Off

Turns Parent Mode on for child forms. While Parent Mode is on, the record selection and navigation controls operate on parent records. When the Parent Mode - Off picture is displayed, Parent Mode is not in effect.

Parent Mode - On

Turns Parent Mode off.  While Parent Mode is off, the record selection and navigation controls operate on child records. When the Parent Mode - On picture is displayed, Parent Mode is in effect.

 

Close Control:

 

Close

Closes the form.

More:

ProMatrix Condition Builder