VHDL and Verilog for Visual Studio

Documentation

V3S | Coding | Hierarchy View


Support

  VHDL
  Verilog

How to Access

V3S main menu

Description

Opens a view which shows the current project's design hierarchy.

Documentation

Important Remark: The Hierarchy View is only updated upon saving a source file. This is due to performance reasons, especially for big projects. You can at any time click the Refresh-button in the Hierarchy View's menu bar.

The Hierarchy View window is a very handy toolwindow which allows the user to quickly navigate through a project's code base. The view organizes the entire project according to its design hierarchy rather than its libraries (there is a separate view for this - refer to   Library View). The following image shows a screenshot of the Hierarchy View for the sample project which can be created by the project wizard (see also   New Project Wizard).

Hierarchy View, most details, include references

The top-level node of the Hierarchy View is by default the top-level entity. You can, however, set any entity/instance as root for the view. The image above shows the design hierarchy of the example design. You can also see the referenced libraries (i.e., the use clauses) of an instance, and its references (i.e., entity, comonent or architecture defintions within the declaring file). The Libraries and References entries can be turned off in the menu-bar.

The following table summarizes all icons of the menu-bar as well as all other important functionality concerning the Library View windows.


Sorting: If this button is active, the subtrees are sorted alphabetically from A to Z by the nodes' displayed names.

Sorting: If this button is active, the subtrees are sorted by category. This means, that all entities are grouped, all architectures are grouped, all packages are grouped, ...

Sorting: If this button is active, the subtrees are sorted by order of declaration within the respective source files. Thus the order of nodes of the tree corresponds to the order of declaration/definition within the respective source file.

Details: When this button is selected, the least details are shown. This basically means that only the direct children of libraries and references are displayed.

Details: If this button is active, a medium level of details are shown in the view. This basically means that one level of detail is added to the tree: For each architecture, entity and package, also their direct children are displayed (i.e., functions, signals, constants, etc.)

Details: If this button is active, most details are shown in the view. All information is now included in the tree: For functions, also their parameters and local variables are included, for components also their generic and port definitions are included, for record-types the single fields are included, ...

Reset root: If you click this button, the top-level entity is set as root node for the Hierarchy view.

Show libraries and references: If this button is active, the Libraries and References nodes are included for each instance. The former includes a list of references packages (i.e., the use clauses), while the latter includes references to the instance's component, architecture or entity definition for faster navigation.

Refresh: Manually update the view. Notice that the view is automatically updated only upon saving a source file. A manual refresh can be forced with this button at any time.
Navigation: You can use the arrow keys to navigate through the tree nodes. Either use the mouse (left-click) or press Enter to jump to the declaration/definition of the currently selected node.
Context-menu: Right-clicking any node of the tree opens the node-specific context menu. Refer to the table below for details.

There is a node-specific context-menu available for each node. Depending on the type of the node, some of the entries might be disabled.

Context-Menu of Hierarchy View

Goto Declaration Jumps to the source code location of the currently selected element in the Hierarchy View. This is the same as simply left-clicking the node or pressing Enter.
Set as Root Enabled for instances/entities only: Sets the respective node as root node for the Hierarchy View.
Find References Finds all references of the currently selected node in the entire project. This is the same as the Find All References... command in the V3S main menu or the code-editor's context menu.
Rename... Opens the Rename... dialog for the currently selected node. This is the same as the Rename... command in the V3S main menu or the code-editor's context menu.
Create Testbench... Opens the Create Testbench... dialog for the currently selected node. The node must be an entity. This is the same as the Create Testbench... command in the V3S main menu or the code-editor's context menu.

See also:

© 2013 - 2017 by ViDE-Software Contact | Terms | Imprint