With C++ code, the Browsing Choices window displays one column to indicate the kind of item, a column to identify the item, and three columns indicating properties, as follows:

The Browsing Choices window provides a facility for sorting items by column. To do this, click in the column you wish to sort on and select "Sort" from the Admin menu.

If you're using Ada, the Browsing Choices window displays packages, tasks, and tagged types in the Kinds column. The properties columns are not used in Ada and appear blank. You can sort the items by kind or name by clicking in the appropriate column and selecting "Sort" from the Admin menu.

---

Note: These features are available only if you have purchased the ProDev Ada package.

---

The Current Subject field indicates the kind and name of the element to be analyzed. It is directly below the menu bar (see Figure 10-2). The label on this field is initially Current Subject. To analyze an element, you can type directly into this field (or select from the Browsing Choices window). The label changes according to the kind of element you select. You can enter the following kinds of elements:

The Show in Static Analyzer toggle is directly to the right of the Current Subject field (see Figure 10-2). When the toggle is set (a check mark and the label Yes appear), the results of all queries are displayed in the WorkShop Static Analyzer window from which the Browser was launched, including the file, line number, and source line for the matching items. If no results are found and the Static Analyzer window is open, it comes to the front with an error message.

The Last Query button is at the top right of the window, directly beneath the Help menu (see Figure 10-2). Clicking this button displays the results of the most recent query in the WorkShop Static Analyzer window from which the Browser was launched.

The Browser View query identification area is directly above the list area (see Figure 10-2). This area displays the most recent query as a sentence containing both the query question and the name of the object of the query. The number of elements matching the query is displayed at the right end of the line.

The lower two-thirds of the Browser View window consists of two lists displayed in side-by-side panes (see Figure 10-2). The lists contain information about the currently selected subject and are organized by category in an outline format. The lists are:

You can change the relative widths of the panes by moving the sash that separates the panes.

The categories in the lists are different depending on whether you are using C++ or Ada code (with ProDev Ada only). Table 10-1 summarizes the contents of each list by programming language. For more information on the lists, see "C++ Member List", "C++ Relation List", "Ada Member List", and "Ada Relation List".

Outline Icons

Each category name appears with an outline icon to its left, that is, a diamond-shaped icon that can be used to collapse (hide) or expand (make visible) the items under that category. Inside the icon there is an arrow that indicates whether the category is in the expanded or collapsed state. If the arrow points downward, the list is in its expanded state; all items are displayed. If the icon points to the right, the category is in its collapsed state; all items in that category are hidden. Clicking the arrow toggles the state of the category, displaying or hiding the category's contents. Another function of the outline icon is to indicate when a collapsed list contains items matching the current query. This is shown with a filled outline icon. See Figure 10-3.

Figure 10-3. Outline List Icons and Indicator Marks

The Browser View member list displays the types, data members, methods, and virtual methods internal to the current class, template definition, or template instance when you are analyzing C++ code. It labels constructor methods as -constructor-> and destructors as --destructor->.

Access (PUBLIC, PROTECTED, or PRIVATE)
    Scope (INSoTANCE or STATIC)
       TYPES
       DATA
       METHODS
       VIRTUAL METHODS

Displaying a Member's Source Code

Double-clicking any member in the member list opens a Source View window containing that member's code with the declaration highlighted. See Figure 10-4.

Figure 10-4. Source View of Class Data Member

The C++ relations list displays the current class and its related classes in the related class list. The categories in the list are:

Within this list, the current class is displayed as follows:

<- This

which refers to the class in the Current Class field.

BASE CLASSES
   <-This
              first_parent_of_This (access type)
                                parent_of_first_parent_class (access type)
               second_parent_of_This (access type)
                               parent_of_second_parent_class (access type)

Derived Classes Category Hierarchy

The Derived Classes category shows the descendants of the current class, if any. Each indented class is a descendant of the class listed above it. If a given class has descendants, it is accompanied by an outline icon, which works in a similar manner to the outline icons in the base classes category and member list.

This schematic gives an example of a possible Derived Classes category:

DERIVED CLASSES first_child_of_This child_of_first_child_class second_child_of_This child_of_second_child_class

Figure 10-5. C++ Relations List Derived Classes Category

---

Note: The features described in this section are available only if you have purchased the ProDev Ada package.

---

The Ada version of the Browser View member list displays packages, task types, and tagged types as its current subjects. Packages have functions as their internal "members." The internal members for task types are entries (under Public) and functions. Tagged types have primitive operations as their internal members.

Access (SPEC PUBLIC, SPEC PRIVATE, or BODY)
   Scope (INSTANCE)
      TYPES
      DATA

Access Categories

The accessibility categories are different depending on the type of Ada entity.

The accessibility categories for packages are:

• spec public—includes declarations of data, functions, and types made in the public part of the package spec

• spec private—includes declarations of data, functions, and types made in the private part of the package spec

• body—includes declarations and definitions of data, functions, and types made in the implementation of the package. These symbols are usable only within the package body.

The accessibility categories for tagged types are:

• spec public—includes data lists components of the tagged type. Functions list primitive operations of the tagged type.

---

Note: There is no spec private or body section for a tagged type.

---

The accessibility categories for task types are:

• spec public—includes functions listed here are entries to the task. Types and data listed here are public (ie usable by a client of the task).

• body—includes types, data, and functions used in the implementation of the task. These symbols are usable only within the task body.

---

Note: There is no spec private section for tagged types

---

The Ada relations list shows parent-derived relationships between tagged types (with ProDev Ada only).

The Preference menu allows you to control how the class information is displayed in the window (see Figure 10-17).

Figure 10-17. Preferences Menu

The selections are:

The Data Members popup menu performs these queries on data members selected in the member display list:

Figure 10-19. Data Members Popup Menu

The Methods popup menu lets you perform the following queries on methods shown in Figure 10-20.

Figure 10-20. Queries on Methods Popup Menu

The Methods popup menu provides these queries:

This section describes the popup menus available in the related class list display. These menus are shown in Figure 10-18. (Note that the queries menu that displays when you select <-This is not shown here; it's exactly the same as the main Queries menu shown in Figure 10-14.)

Many of the items in the class popup menus are common to more than one menu. To eliminate the redundancy of describing them in each menu, this section presents all the queries in a single list in alphabetical order. The menus they belong to are shown in parentheses. Here are the menu items:

"New Browser View" (all menus except Friend Functions)		Opens a new Browser View window displaying the selected class.
"Show Source" (all menus)		Opens a Source View window on a file containing the declaration of the selected item. The first line of the declaration is highlighted in the source.
"What Destroys" (Uses and Used By)		Highlights all members of the current class that destroy the selected class.
"What Instantiates" (Uses and Used By)		Highlights all members of the current class that instantiate the selected class.
"What Is Declared" (Base Classes)		Highlights all methods declared by the selected base class.
"What Is Defined" (Base Classes)		Highlights all members defined by the selected base class.
"What Is Overloaded" (Derived Classes)		Highlights all members of the current class that are overloaded by the selected class.
"What Is Overridden" (Base Classes)		Highlights all the methods of the selected base class that are overridden by the current class.
"What Is Overridden" (Derived Classes)		Highlights all the methods of the current class that are overridden by the selected derived class.
"What Is Used" (Friends)		Highlights all members of the current class that the selected friend class uses.
"What Is Used" (Derived Classes and Used By Classes)		Figure 10-21. "What Is Used" SubmenuCurrent Class Pop-Up Menu Contains these queries in the submenu (see Figure 10-7): "by Accessing Any Member" highlights all members (of the current class) that the selected class uses. "by Calling Methods" highlights all methods (of the current class) that the selected class uses. "by Accessing Data Members" highlights all data members (of the current class) that the selected class modifies, reads, or takes the address of. "by Modifying Data Members" highlights all data members (of the current class) to which the selected class assigns a value. "by Reading Data Members" highlights all data members (of the current class) from which the selected class reads a value.
"What It Uses" (Friend Function)		Highlights all members of the current class that the selected friend function uses.
"What Uses" (Friend of Class)		Highlights all members of the current class that use the friend class.
"What Uses" submenu (Uses Classes)		Contains these queries in the submenu (see Figure 10-7): Figure 10-22. "What Uses" SubmenuCurrent Class Pop-Up Menu "by Accessing Any Member" highlights all members (of the current class) that use the selected class. "by Calling Methods" highlights all methods (of the current class) that use the methods of the selected class. "by Accessing Data" highlights all data members (of the current class) that modify, read, or take the address of data members of the selected class. "by Modifying Data" highlights all data members (of the current class) that assign a value to data members of the selected class. "by Reading Data" highlights all data members (of the current class) that read a value from data members of the selected class.

You can display the graphical views by selecting any of the following items from the Views menu of the Browser View window:

Once the Graph Views window is displayed, you can switch to any of the other relationships by using the Relationship menu at the bottom right of the Graph Views window (see Figure 10-23).

The Graph Views window Views menu (see Figure 10-23) commands control which classes included in the current fileset are displayed in the Graph Views window. The choices are:

Double-clicking any subject in the Graph Views window causes it to become the new current subject in both the Browser View and Graph Views windows.

You add, replace, or remove methods in the Call Graph by choosing from the Call Graph submenu in the Methods popup menu in the Browser View member list (see Figure 10-25), as follows:

The action you request is displayed in the message area in Browser View. In the Call Graph window, there is also a message area that identifies the method and its arguments.

In the Call Graph window, double-clicking any method node opens a Source View window displaying the code that defines the method. The definition is highlighted in the source.

For information on manipulating graphs, see Appendix A, "Using Graphical Views," in the ProDev WorkShop Overview.

The Call Graph window's Admin menu contains the following selections: