| **Navigation:**  [[templates.htm|Templates]] > Guide to all Templates > Wizard and Utility Templates >====== Browse Procedure Wizard utility template ====== | [[wizard  control model.htm|{{btn_prev_n.gif|Previous page}}]][[templates.htm|{{btn_home_n.gif|Return to chapter overview}}]][[tplwizardform.htm|{{btn_next_n.gif|Next page}}]] |
|  ||

This wizard creates a multi-keyed Browse Procedure from an existing dictionary file definition. It also creates associated Form (Update) procedures, if you specify that updates be allowed.

There are three models the wizard can use to create procedures: Button, Toolbar, or Both. See [[wizard  control model.htm|Wizard-Control model]]

After the introduction screen, you are presented with the following options:

**Theme Selection**

| **Theme** | Select from the drop list of themes. Themes are groups of settings that control colors, fonts, icons, backgrounds, positions and much more - for Frame, Browse, Form and Report procedures. You will have the opportunity to create a new theme as you progress through the wizard. Select a starting or default theme here. |
| **Save Settings** | After you have selected a theme, you have the option to save these settings for any future applications that you create. |

**What name should be used as the label of the procedure?**

Type the browse procedure name.

**Which file do you want to browse?**

Press the ellipsis (...) button to select a file from the dictionary.

**Browse using all record keys**

Check this box to make the list sortable on all keys. Clear the box to specify a single sort key.

**Allow the user to update records**

Check this box to generate a subordinate procedure to update the table. Optionally, provide the name of the update procedure. Clear the box to make the list read only.

**Call update using popup menu**

Check this box to provide right-click popup menus on the Browse list in addition to any command or toolbar buttons.

**Parent Record Selection**

This prompt appears only if you specify a single sort key that is the linking key in a Many:One relationship. The Browse Wizard infers from this that you may want to browse only the child records for a specific parent record. Select one of the following to confirm or deny this inference.

**Do not select by parent record**

Do not limit the browse - in other words, browse all records.

**Select parent record via button**

Browse only the child records for a specific parent record. Provide a button to select the parent record.

**Assume that the parent record is active**

Browse only the child records for a specific parent record. Assume the parent record is already active.

**Provide buttons for child files**

Check this box to provide buttons on the Browse window to access related child tables. Alternatively, related tables may be accessed from the generated update procedure.

**Provide a "Select" button**

Check this box to provide a "Select" button that displays when the Browse procedure is called to select a record, but is hidden when the Browse is called to update records.

Which control model should the Application use?

| **Button** | The wizard builds the browse with traditional Insert, Change, and Delete command buttons that appear on each dialog. |
| **Toolbar** | The wizard builds the browse to use global toolbar command buttons that appear on the application frame. See Control Templates - FrameBrowseControl. |
| **Both** | The wizard builds the browse to use both traditional dialog command buttons and global toolbar command buttons. |

**Customization**

Wizards have different "look and feel" settings and actions called //themes//, which can be modified and saved for use in other applications. Themes are set and controlled by a variety of customization options.

Press the **Next** button to accept the selected theme's settings, or press one of the customization buttons to modify them at this time.

__Browse Customization__TPLWizardBrowseCustomization

__Form Customization__TPLWizardFormCustomization

**Overwrite existing procedures**

Check this box to overwrite existing procedures with the same names. Clear the box to preserve existing procedures.

On the last dialog, the **Finish** button is enabled. If you are satisfied with your answers, press the **Finish** button. You also have the option here to **Save Changes**, where any changes to customization options are saved to the theme that you selected at the start of the wizard. If you wish, you can opt to **Save to a new theme.**

The Browse Procedure Wizard creates the procedure(s) based on the dictionary file and the answers you provided, and then displays the Procedure Properties dialog for your new procedure.