Include Hierarchy View
This view is a graphical representation of the relationships between the source files
for the object being viewed. When the input object for the view is a project, the include
relationship between the project's source files is shown. For a source file input object,
the inheritance relationship for this input source file is displayed. You can not modify
the project using this view.
The selected class is darker than the other nodes. Click the plus sign controls on a
graph node to expand the graph one level. Click the minus sign controls on a graph node to
collapse the entire sub-graph. A solid link between nodes in this view indicates a file
with a #include statement was included during the build. A dashed link between nodes
indicates that the #include statement was ignored during the build. A #include statement
can be ignored if the included source file is explicitly listed in a configuration file
source directive. A source file listed in the configuration file is called a primary
source.
Some source files may be represented by two nodes. This view shows the include
relationship as seen internally by the codestore. If a file is both found in a #include
statement within the source code, and listed explicitly in the configuration file as a
primary source file, then the source file will have two nodes. The first node is a top
level base node representing its actual inclusion by the kernel as a primary source file.
The second node is a child node with a dashed link representing a #include statement that
is not used to include the source file since it was previously included as a primary
source file. Use the view's background pop-up menu action Show Actual Includes
Only to remove the child node from the view.
The zoom controls and menu actions are enabled when a graph is not entirely visible in
a pane. Click the zoom in control
to increase the zoom
by one step. Click the zoom out control
to decrease the
zoom by one step. Drag the slider between the two controls to increase or decrease the
zoom more rapidly.
Click mouse button 2 on the view background or on a node to display pop-up menus that
contains actions. For the view background, these actions include the following:
- Live Find displays the Live Find controls for searching the view. The
search results depend on the graph layout. In a vertical layout, the search starts left to
right and then top to bottom. In a horizontal layout, the search starts top to bottom and
then left to right.
- Vertical Layout and Horizontal Layout control whether
the graph has a vertical top-down orientation, or a horizontal left to right orientation.
- Show Minimal Graph displays the minimum number of nodes required to
describe the input object. When the input object is a source file, only the node for the
source file is shown. When the input object is an aggregate such as a project, only the
base source files are shown.
- Show Entire Graph displays every node related to the input object.
- Show Ancestors and Descendents displays only the direct children and
parents for the input object. This action only applies to single input objects such as
classes since for an aggregate input object this action is equivalent to Show
Entire Graph.
- Default Initial Display controls how the graph for the input object is
displayed when it is viewed for the first time. After the initial display, you can change
the display attributes, and those changes are saved.
- Position to Selected Object scrolls the selected object back into view,
if it is not visible in the pane.
- Position to Input Object scrolls the input object back into view, if it
is not visible and if it exists in the graph.
- Zoom In increases the zoom by one step.
- Maximum Zoom In increases zoom to its maximum value.
- Zoom Out decreases the zoom by one step.
- Maximum Zoom Out decreases zoom to its minimum value.
- Zoom Overview displays a the Overview window that shows the entire
graph with a shaded area superimposed representing the visible part of the graph. Drag the
shaded area by the edge to change the zoom factor, or drag it in by the internal area to
scroll the visible part of the graph. If another view receives focus, the Overview is
hidden until the hierarchy view receives focus again.
- Print displays a print dialog box from which you select options and
print the graph.
- Redraw redisplays the graph based on the nodes currently displayed.
Gaps left by removed nodes are filled in.
- Show Actual Include Files Only controls if the graph displays include
files specified in the configuration file or not. If this item is selected, only those
files included by a #include statement and not defined in the configuration file will be
shown.
- View Settings displays the View Settings view for the Include Hierarchy
view in a floating pane.
For the object pop-up menu, the actions include the following:
- Show All Parents expands and shows all of the ancestors of a node, if a
node has ancestors.
- Show All Children expands and shows all of descendents of a node, if a
node has descendents.
- Hide Node removes the node from the visible graph. Select plus sign
control on the top of the hidden node's children, or the bottom plus sign control on the
node's parent to redisplay the hidden node.
- Hide Node and Parent Tree removes the selected node and its ancestors
from the visible graph.
- Hide Node and Child Tree removes the selected node and its descendents
from the visible graph.
- Hide all Sibling Nodes removes the nodes that share the same parents of
the selected node. The selected node is not removed.
If you want help on another aspect of the IDE interface, more IDE
interface help is available.

Convert Included Sources to Primary Sources
Change Settings for Views