| Navigation: Templates > Guide to all Templates > Control Templates >====== FrameBrowseControl ====== |    |
The FrameBrowseControl places thirteen (13) standard command buttons on the toolbar of an MDI APPLICATION (Frame). When the user presses these buttons, the template generated code posts appropriate events (scroll up, scroll down, add, change, delete, help, etc.) to the active procedure.
You may delete buttons that your application does not use. For example, the standard templates by default do not use the locate button.
The buttons are designed to work with the BrowseBox Control template, the RelationTree Control template, and the FormVCRControls Extension template; that is, the buttons remain disabled until the program calls a procedure with a BrowseBox template or a RelationTree template whose Accept browse control from Toolbar box is checked, or the BrowseBox procedure calls a Form procedure with a FormVCRControls extension template.
In addition, the called procedure's WINDOW must have the MDI attribute–the standard Browse and Form templates declare MDI windows by default–you don't need to do anything special to accomplish this. The BrowseBox and RelationTree templates also checks the Accept browse control from Toolbar box by default–so again, you don't need to do anything special to accomplish this.
The FrameBrowseControl toolbar buttons operate as follows:
 | Scrolls to the first row in a BrowseBox or to the previous parent record in a RelationTree. For Form procedures, saves the current record before scrolling. |
 | Scrolls up one page in a BrowseBox or to the previous record on the same level in a RelationTree. For Form procedures, saves the current record before scrolling. |
 | Scrolls up one row in the BrowseBox or to the previous record on any level in a RelationTree. For Form procedures, saves the current record before scrolling. |
 | Locates a specific record in a BrowseBox. See Control Templates–BrowseBox for information on specifying these locators. |
 | Scrolls down one row in the BrowseBox or to the next record on any level in a RelationTree, expanding the tree branch if necessary. For Form procedures, saves the current record before scrolling. |
 | Scrolls down one page in the BrowseBox or to the next record on the same level in a RelationTree. For Form procedures, saves the current record before scrolling. |
 | Scrolls to the last row in the BrowseBox or to the next parent record in a RelationTree. For Form procedures, saves the current record before scrolling. |
 | Selects the highlighted row in a BrowseBox.This is only appropriate when the Procedure is called to select a record. For example, when called as a lookup. |
 | For a BrowseBox, calls a Form procedure to add a new record. For a RelationTree, calls a Form procedure to add a child record of the currently highlighted record. For a Form procedure, adds another record of the same type. |
 | Calls a Form procedure to change the record highlighted in the BrowseBox or RelationTree. |
 | Deletes the record highlighted in the BrowseBox or RelationTree. The BrowseBox delete behavior is determined by the settings on the Update Buttons Control template. |
 | On a Form procedure only, pastes into the field with focus, the corresponding value from the previously processed record (the value in the record buffer). In other words, repeat the value from the previous saved record. Also known as the “ditto” button. |
 | Invokes Windows standard help behavior: calls WINHELP.EXE with the help topic or keyword specified by the WINDOW's HLP attribute. |
The Properties dialogs for the FrameBrowseControl buttons is the normal Button Properties dialog.