Contents | Previous | Next

#
Include Browser

Some programming languages provide a facility for including other source files. In C/C++ this is achieved using the `#include` preprocessor directive. The Include Browser lets you display Includes and Included by relationships simultaneously.

## Using the Include Browser

Start the Include Browser in one of the following ways:

- from the Windows menu, select New View -> Include.

- click the Include toolbar button (see Include Browser button).

- choose the Include tab in the Editor.

Include Browser Window

To see further relationships, after selecting a file in the Include Browser window, use the right and left pointing-hand tool icons to show files included by the selected file (black connection arrows) and files that include the selected file (red connection arrows).

To determine the number of levels shown for a query, enter a positive integer in the Levels text entry box.

### Reducing Displayed Information

Holding down the right mouse button on a symbol in the Include Browser window brings up a popup menu that allows you to show or hide include information.

Include Browser Window, Right Mouse Button Down

This is useful when the Include Browser displays more information than you need, and you'd like to hide all relationships but the particular one you're interested in.

### Include Preferences

You'll find preference settings for the Include Browser window in the Include tab of the Preferences dialog. To find this dialog, select one of the following:

1. In the Symbol Browser, from the File menu, select Project Preferences. In the Include Browser, from the Edit menu, select View Preferences.
2. Choose the Include tab.

Include Tab of the Preferences Dialog

##### Layout

Display order:
Left to right displays the include hierarchy from left to right; Top to Bottom displays it from top to bottom.

Display layout style:
Select Tree to display includes in tree layout; select ISI to display them in ISI layout.

Vertical space:
Enter the number of vertical pixels between symbols in the Include Browser window.

Horizontal space:
Enter the number of horizontal pixels between symbols in the Include Browser window.

##### Include directories

Locate Headers
Uncheck this box to prevent included files from being parsed.

In the Include Directories box you can choose which directories should be searched for include files. Using the set of directories shown in Include Tab of the Preferences Dialog, for example, if `stdio.h` is a reference then Source-Navigator looks first for the file `/usr/include/stdio.h`, then for `./stdio.h`, and so on down the list. The order of the list is important, because the first file found is the one that will be used by the Include Browser.

Contents | Previous | Next