Using the Navigation Bar in Hierarchy Browsers
Each hierarchy browser (for example, the Class Browser) can display a navigation bar (shown in the following image), with drop‑down combo boxes from which you can select a schema, a class, and a method.
Selecting a schema, class, or method refreshes the current browser with the selected entity; for example, selecting a schema refreshes the display to that schema (as though a new browser was opened) and selecting a class selects the class (as though a class was selected using F4).
For details about filtering the entries displayed in list boxes associated with the navigation combo boxes, see "Filtering Entries in Combo Box and List Box Text", elsewhere in this chapter.
The display is updated when the combo box is closed and a list entry has been selected. This enables you to use the arrow keys to scroll through the entries and enter text to refine the list before clicking the required entry or pressing Enter.
The navigation bar is hidden, by default. Toggle the display of the navigation bar by checking or unchecking the Show Navigation Bar check box on the Browser sheet of the Preferences dialog. The setting of this check box is saved in your user profile and can be extracted to a preferences initialization file by using the existing Export Preferences functionality provided on the Miscellaneous sheet of the Preferences dialog. You can also toggle the navigation bar display by using the View menu Show Navigation Bar command.
The navigation bar combo boxes, from left to right, are as follows.
-
When the combo box on the left of the browser is dropped down, it lists the name of every schema defined in your system, including versioned schemas (which are displayed with the versioned background color of your user preference).
From version 2020.0.01 and higher, changing the schema using the navigation bar combo box in the Class List of a Class Browser to navigate to the parent class in a superschema does not select the Object class in the superschema by default. The selected class is the first class previously selected in the class hierarchy that is common to both schemas; that is, if a:
-
Superschema is selected, the class selected will be the superclass of the previously selected class.
-
Subschema is selected, the previously selected class will again be selected in that schema.
The text box portion of the combo box usually displays the name of currently selected schema.
-
-
When the middle combo box is dropped down, it lists in alphabetical order the name of every class defined in the selected schema.
Selecting a class in the list is equivalent to clicking on the class in the Class List of the browser.
The text box portion of the combo box usually displays the name of the currently selected class.
The list does not include any superschema classes not marked as copy classes in the currently selected schema. To access such classes, press F4.
-
When the combo box at the right is dropped down, it lists in alphabetical order the name of every method in the currently selected class.
When the class is a form, the list includes all event methods defined for the form, menus, and all controls. The event methods display the full name (for example, cmbCustomers_click).
This list does not include the names of any superclasses, regardless of the setting of the View menu Show Inherited command.
Selecting a method in the list displays the selected method. If the method is in the currently displayed method list, that method entry is selected. If the method is not in the currently displayed list, the All folder of the Methods List is displayed and the method is selected in the methods list of the combo box.
If the method is an event method, the associated form, control, or menu item in the Properties List is selected (and the All folder in the Properties List is displayed).
If the method is not an event method, the properties selection is unaffected(that is, the <methods> entry is no longer displayed in the Properties List).
If one of the combo box entries is selected and the current method display has been changed but not saved, you are prompted to save or discard the changes, or to cancel the action.
Each combo box enables you to enter text. Changing the combo box text causes the display of only entries that contain the specified text somewhere in the entity name.
The search process handles uppercase searches if all text entered after the first character is uppercase. The list then includes all entries in which the first character of the entity name matches the first entered character and the entity name has uppercase characters that match the order of the remaining entered uppercase text. For example, entering sNT in the method combo box at the right of the navigation bar include method names searchNameTextOnly and someNumberedTest.
Because the same form can be used to access different schemas, the browser history in the displayed History menu includes the schema name if the entry is not for the currently selected schema.
If the accessed schema was versioned, any history menu list entry for the versioned schema (for example, the schema or a class name) is preceded by an asterisk (*) character.
2018.0.01 and higher
