Introduction

prevnext

Controlling Graphics Layout


The two graphical browsers, Hierarchy and Declaration have a variety of configuration options which may be set via the Options menu of the menu bar. These options control the layout and drawing of the graphic views and vary based on the type of view.

In addition, certain toolbar actions are in effect when a Graphical View is in focus..


Scale Menu

The scale menu allows you to choose the size of the text used. All picture sizes and layouts vary with text point size. The currently selected size is shown with a check mark on the left.

Note that other point sizes can be added through customization of configuration files found in the Understand for C++ installation directory. Contact support@scitools.com for information on how to do this.

Text Menu

The Text menu sets the manner that entity names are trimmed or altered for layout of graphics. Names may be truncated to a certain length or wrapped at a certain length.


- No Truncation
Uses the name as defined in the source code. The default.
- Truncate Short
Cuts off names at 10 characters.
- Truncate Medium
Cuts off names at 20 characters.
- Truncate Long
Cuts off names at 30 characters.
- Wrap Short
Wraps the name at between 8 and 10 characters. Location in that range depends on if a natural wrapping character is found. Natural wrapping characters are "._-:".
- Wrap Medium
Similar to Wrap Short except wrapping range is 15-20 characters.
- Wrap Long
Similar to Wrap Short except wrapping range is 20-30 characters.

Function Pointer

The Function Pointer menu controls if function pointers are displayed as invocations in the Call and CallBy trees.Longer versus shorter names can alter the layout of pictures substantially.

Layout

The Layout menu is used to control the layout algorithm for a hierarchical chart. Only available on hierarchy views (invocation, callby, include, includeby).

· Crossing - a left-right view, minimizing space used but sacrificing some readability by permitting lines between entities to cross.


· Non-Crossing - an up down layout, using more space in some situations but enhancing readability by having no crossing lines. Multiple occurrences of the same sub-tree are not shown more than once.


Level

The Level menu indicates number of levels to be traversed when the layout a hierarchical view. The default value is "All Levels". Values of 1 to 5 may be set. This option is available only on hierarchical views (invocation, callby, include, includeby).

The invocation view of function Alternate with Levels set to "All Levels" next to the same view with Level set to 1:

Unresolved

The Unresolved menu controls if entities that have been used but no declaration was found should be drawn. This option is available on any graphical view (hierarchy and declaration). Unresolved functions and entities are those used in the analyzed source without a definition in the same source. Unresolved header files are those included but not found along a declared include path (either a compiler or project include path).


Unresolved entities are drawn as normal but with a dashed border:


Parameters

The Parameters menu controls if parameters are shown in declaration or hierarchical views. Available on any graphical view showing hierarchies of C functions (invocation and callby).


Type Text

The TypeText menu tells declaration views (Function Declaration, C File Declaration, Header File Declaration) to include types on the view. Default is On.

Includes

The Includes menu controls if include files are drawn on file declaration diagrams (C file, Header file). Default is On.

Included By

If IncludeBy is on (default) then files that include the Header File being drawn in a Header File Declaration view are shown.

Static

· The Static menu controls if static functions are drawn in function, C File and Header File declaration views. Static functions are those declared using the "static" keyword. They are visible only within the file they are declared in. If enabled static functions are drawn with the edge of their box inside the edge of the outer declaration box for their enclosing unit (C file). Default is On.


Dependent Of

The DependentOf menu controls if files a C file is dependent on are drawn in the C File Declaration and File Depends views. Default is On.

Dependent

If Dependents are on (the default) then files dependent on the C file being drawn in a C File Declaration or File Depends view are drawn.

Invocations

If Invocations are on (default) then functions which are invoked by the function being drawn in the File Declaration view are shown.

prevnext


Scientific Toolworks, Inc.
http://www.scitools.com
Voice: (802) 763-2995
Fax: (802) 763-3066
support@scitools.com
sales@scitools.com