wguibrow.gml

开放源码的编译器open watcom 1.6.0版的源代码

Press the space bar to enable the currently selected module file.
.result
This places an X in the box indicating that the module file is enabled
and will be browsed.
.step Repeat step 2
until you have enabled all desired module files.
.step Click on
.us OK
on the
.us Module
dialog.
.result
This closes the
.us Modules
dialog and updates the database file.
.endstep
.np
To enable all of the module files on the
.us Modules
window, click on the
.us Enable All
button.
Click on
.us OK
to update the database file and close the
.us Modules
window.
.*
.endlevel
.*
.endlevel
.*
.section Global Views
.*
.np
The menu items under the View menu let you display a global view of
your program.
A global view is one that displays relationships between all symbols
in your program.
The following are global views.
.begpoint $break
.point List
Displays a list of all symbols in your program
.point Inheritance
Displays the class inheritance graph for your program
.point Call
Displays the call graph for your program
.endpoint
.np
Once a global view has been displayed, you can view detailed
information for the symbols in the global view.
Refer to the section entitled :HDREF refid='brview'. for a discussion
on displaying detail information.
.np
It is possible to specify a query that restricts the symbols displayed
in global views.
See the section entitled :HDREF refid='brglob'. for more information.
.*
.beglevel
.*
.section *refid=brlist The List View
.*
.np
.ix '&br' 'browsing symbols'
.ix 'symbols' 'browsing'
Using the &br to view the symbols in your program is much faster than
searching through your source code for symbol information.
From the symbols list you can quickly access detailed information on a
symbol that tells you where the symbol is used and where it is
defined.
.np
To view a list of all symbols in the current Browser database file,
choose
.us List
from the
.us View
menu.
This displays a window which can list all symbols in your program.
The window has a vertical scroll bar that allows you to scroll through
the list of symbols in your program.
Since your program may contain a very large number of symbols, the
Browser does not load all the symbols in your program from the
database.
Instead, only the number of symbols that can be displayed in the
window are loaded.
As far as the Browser is concerned, this list is infinite.
For this reason, the scroll thumb on the vertical scroll bar is
positioned in the middle of the vertical scroll bar and cannot be
moved.
Click below the vertical scroll thumb to view the next page of symbols
and above the vertical scroll thumb to view the previous page of
symbols.
.figure *depth='2.66' *scale=51 *file='brow4' The List window displays all symbols in the current browser database file.
.np
Each symbol has a icon to its left.
A letter marking each icon indicates the symbol type in the source
code as follows:
.begpoint
.point F
Function
.point C
Class
.point T
Typedef
.point V
Variable
.point E
Enum
.endpoint
.np
There are several ways to display the detail view of symbols.
When you reveal the detail view, the file folder icon changes to an
open file folder.
To close the detail view dialog, click on the file folder.
This changes the icon back to a closed folder and closes the dialog.
To reveal the detail view of a symbol you can perform any of the
following actions:
.begbull
.bull
The file folder icons are hot spots that display the detail view of the
selected symbol.
To activate the hot spot, click once on the symbol name to select it
and press ENTER to reveal the detail view.
.bull
Click once on the file folder to reveal the detail view for that
symbol.
.bull
Click once on the symbol name to select it and choose
.us Detail
from the
.us Detail
menu.
.bull
Double click on the symbol name.
.endbull
.*
.section The Class Inheritance View
.*
.np
.ix '&br' 'browsing classes'
.ix 'browsing classes'
.ix 'inheritance menu item'
Selecting
.us Inheritance
from the
.us View
menu displays the inheritance hierarchy of all of the C++ classes in
your program using a tree.
This allows you to see the relationships between base classes and
derived classes.
In the inheritance hierarchy, each node represents a class.
.figure *depth='2.66' *scale=51 *file='brow5' The Inheritance view displays the hierarchy of all C++ classes in your program (graph view shown).
.np
There are two different tree views you can choose from to display the
class hierarchy:
.begpoint $break
.point Graph view
The graph view displays each class in a box.
A box, or node, is connected to another node if one is a derived class
of the other.
The root node of the tree is the base class for all nodes in the tree.
The tree is initially fully expanded.
See the section entitled :HDREF refid='brtree'. for more information
on removing and expanding nodes from the tree.
.point Outline view
The outline view displays the same information as the graph view but
in a different way.
The outline view is initially fully collapsed.
That is, only the base classes are displayed.
In order to view the derived classes of a node, you must single click
on the node.
This expands the node, displaying all its immediate derived classes.
See the section entitled :HDREF refid='brtree'. for more information
on removing and expanding nodes from the tree.
.endpoint
.*
.section The Function Call Tree View
.*
.np
.ix '&br' 'browsing functions'
.ix 'browsing functions'
.ix 'call menu item'
Selecting
.us Call
from the
.us View
menu displays the function call tree for all functions in your
program.
This allows you to see all the functions that a given function calls
and conversely all functions that call a certain function.
In the call tree, each node represents a function.
.figure *depth='2.66' *scale=52 *file='brow6' The Call view displays a call tree for all functions in your program (outline view shown).
.np
There are two different tree views you can choose from to display the
function call tree:
.begpoint $break
.point Graph view
The graph view displays each function in a box.
A box, or node, is connected to another node if one function calls the
other.
The tree is initially fully expanded.
See the section entitled :HDREF refid='brtree'. for more information
on removing and expanding nodes from the tree.
.point Outline view
The outline view displays the same information as the graph view but
in a different way.
The outline view is initially fully collapsed.
In order to view the functions called by the function specified in the
node, you must single click on the node.
This expands the node, displaying all functions it calls.
See the section entitled :HDREF refid='brtree'. for more information
on removing and expanding nodes from the tree.
.endpoint
.*
.section *refid=brtree Manipulating the Tree Views
.*
.np
.ix '&br' 'graph view'
.ix '&br' 'outline view'
With both the graph view and the outline view you can change the
information displayed in the following ways:
.begbull $compact
.bull
select the root nodes you want to view
.bull
expand any node in the view
.bull
collapse any node in the view
.endbull
.np
You expand and collapse nodes in the graph and outline views to hide
and reveal descendant and ancestor nodes of the selected node.
There are two ways to expand and collapse nodes:
.begbull $compact
.bull
choose the desired function from the
.us Tree
menu
.bull
click on the node (applies only to the outline view)
.endbull
.np
In addition to these functions, you can force the graph to be redrawn
when a node in the tree view is collapsed.
By default, collapsed nodes will leave a gap in the graph.
Redrawing the graph removes these gaps.
This feature is controlled by an option.
See the section entitled :HDREF refid='brconf'. for more information.
.np
Clicking on the right mouse button when the mouse cursor is in a tree
view will automatically display the
.us Tree
menu.
This allows you to perform the actions in the
.us Tree
menu without actually going to the menu bar.
.*
.beglevel
.*
.section Selecting Root Nodes
.*
.np
.ix 'Root Nodes'
.ix 'Nodes' 'root'
.ix '&br' 'selecting root nodes'
Select
.us Select Root Nodes
from the
.us Tree
menu to change the root nodes that are displayed.
The root nodes you select appear in the graph or outline view; all
other root nodes are hidden.
.np
Choosing
.us Select Root Nodes
from the
.us Tree
menu opens the
.us Select Root Nodes
dialog.
This dialog lists all of the symbols that appear as a root node.
Each symbol in the
.us Select Root Nodes
dialog has a check box.
When enabled, this check box is marked with an
X, indicating that the symbol will appear as a root node in the
display.
.figure *depth='2.32' *scale=52 *file='brow7' On the Select Root Nodes dialog, choose the symbols you want to appear as root nodes.
.*
.beglevel
.*
.section Disabling Root Nodes
.*
.ix 'Root Nodes' 'disable'
.ix '&br' 'disable root nodes'
.begstep
.step Click in the check box
of the root node you want to disable.
Alternatively, use the up and down arrow keys to select the root node
you wish to disable.
Press the space bar to disable the currently selected root node.
.result
The X disappears meaning that the root node is disabled and will not
appear in the display.
.step Repeat step one
until you have disabled all desired root nodes.
.step Click on
.us OK
in the
.us Select Root Nodes
dialog.
.result
The
.us Select Root Nodes
dialog closes and the display is updated.
.endstep
.np
To disable all of the root nodes in the
.us Select Root Nodes
dialog, click on the
.us Disable All
button.
This removes Xs from each box in the
.us Select Root Nodes
dialog.
Click on
.us OK
to close the dialog and update the display.
.begnote
.mnote Note:
This disables the selected root nodes only for the active view window.
.endstep
.*
.section Enabling Root Nodes
.*
.ix '&br' 'enable root nodes'
.ix 'Root Nodes' 'enable'
.begstep
.step Click in the check box
of the root node you want to enable.
Alternatively, use the up and down arrow keys to select the root node
you wish to enable.
Press the space bar to enable the currently selected root node.
.result
An X appears in the box indicating that the root node is enabled and
will appear in the display.
.step Repeat step one
until you have enabled all desired root nodes.
.step Click on
.us OK
in the
.us Select Root Nodes
dialog.
.result
The
.us Select Root Nodes
dialog closes and the display is updated.
.endstep
.np
To enable all of the root nodes in the
.us Select Root Nodes
dialog, click on the
.us Enable All
button.
An X appears in each box on the
.us Select Root Nodes
dialog.
Click on
.us OK
to close the dialog and update the display.
.begnote
.mnote Note:
This enables the selected root nodes only for the active view window.
.endstep
.*
.endlevel
.*
.section Expanding Nodes
.*
.np
.ix 'Nodes' 'expanding'
.ix '&br' 'expanding nodes'
You can expand the display all at once, one level at a time, or one
branch at a time.
To expand by levels and branches, you must first select the node you
want to expand.
Do this by clicking once on the desired node.
.begpoint $break
.point Expand One Level
Choose
.us Expand One Level
from the
.us Tree
menu to display all of the immediate children for the selected node.
.point Expand Branch
Choose
.us Expand Branch
from the
.us Tree
menu to display all descendants of the selected node.
.point Expand All
Choose
.us Expand All
from the
.us Tree
menu to fully expand all of the enabled root nodes.
Disabled root nodes do not appear in the display.
.endpoint
.*
.section Collapsing Nodes
.*
.np
.ix 'Nodes' 'collapsing'
.ix '&br' 'collapsing nodes'
You can collapse the display all at once or one branch at a time.
To collapse by branches, you must first select the node you want to
collapse.
Do this by clicking once on the desired node.
.begpoint $break
.point Collapse Branch
Choose
.us Collapse Branch
from the
.us Tree
menu to hide all descendants of the selected
node.
.point Collapse All
Choose
.us Collapse All
from the
.us Tree
menu to collapse all of the nodes and display only the root nodes.
.endpoint
.*
.beglevel
.*
.section Using the Keyboard
.*
.np
.ix 'expanding and collapsing nodes' 'using the keyboard'
.ix 'using the keyboard' 'to expand and collapse nodes'
You can expand and collapse the symbols using key sequences.
Click once on the symbol name to highlight it and press one of the
following keys:
.begpoint $break
.point +
Expand the symbol one level
.point -
Collapse the symbol one level
.point *
Expand all descendants of the selected node.
This is the same as choosing
.us Expand Branch
from the
.us Tree
menu.
.point CTRL *
Expands all of the enabled root nodes.
This is the same as choosing
.us Expand All
from the
.us Tree
menu.
.point CTRL -
Collapses all of the symbols and displays only the root nodes.
This is the same as choosing
.us Collapse All
from the
.us Tree
menu.
.endpoint
.*
.endlevel
.*
.endlevel
.*
.endlevel
.*
.section *refid=brview Viewing Detail Information
.*
.np
.ix '&br' 'view detail information'
Once a global view is displayed, you can view detailed information for
a symbol in the global view in several ways:
.begbull $compact
.bull
Double click on the desired symbol.
.bull
Click once on the desired symbol to select it; then choose
.us Detail
from the
.us Detail
menu.
.bull
Click once on the desired symbol to select it then press ENTER.
.endbull
.np
From the list view, you can reveal the detail view if you:
.begbull
.bull
Click once on the icon to the left of the symbol.
.endbull
.np
Performing any of these actions reveals a detail view window for the
selected symbol.
The same information appears in this window regardless of the method
used to access it.
.figure *depth='4.20' *scale=50 *file='brow8' The detail view displays detailed information for the selected symbol.
.np
The detail view window displays the source file where the symbol is
defined or declared and it shows you what the symbol looks like in
your source code.
.np
A list box appears in the detail view window when you select a symbol
whose type is a function, class, or enum.
The list box contains information specific to the symbol type, as
follows.
.begpoint $break
.point Functions
The list box displays, where applicable, local variables for the
function.
.point Classes
The list box displays member variables and member functions for the
selected
class and any inherited classes.
The &br divides this information into three categories:
.begbull $compact
.bull
Public
.bull
Private
.bull
Protected
.endbull