Reference

Visual Studio Toolbar

IncludeManager's commands can be accessed via its toolbar. The icons represent the following commands:

	Show Include Graph - brings up the graph window displaying the include graph of the currently-active file.
	Project Include Graph - brings up the graph window displaying the include graph of the currently-selected project.
	Show Build Impact Graph - brings up the build impact window displaying the build impact dependencies of the currently-active file.
	File Details View - brings up the detail view showing a tabulated list of dependencies for the currently-active file.
	Project Details View - brings up the detail view showing a tabulated list of dependencies for the currently-selected project.
	Options - displays the Options window.

Include Graph Toolbar

The icons in the toolbar of the include graph window have the following meanings:

	Save - saves the current graph as a bitmap image.
	Print - prints the current graph.
	Find - searches the current graph. Subsequent presses find the next match. The search term is taken from the edit box adjacent to the find icon.
	Move - when selected, dragging in the include graph will move (pan) the graph around.
	Zoom - when selected, dragging up and down in the include graph will zoom in and out of the graph.
	Zoom In - zooms in to the graph.
	Zoom Out - zooms out of the graph.
	Zoom To Fit - zooms the graph so as to fit the size of the include graph window.
	Refresh - forces the display to refresh.
	Options - brings up the IncludeManager Options window.

Include Graph Legend

Files are represented within the include graph with the following symbols:

	A source file is represented by a solid square box. Its default colour is blue, and is configurable in the Options window.
	A user header file is also represented by a solid square box. Its default colour is white, and is configurable in the Options window.
	A system header file is represented by a diamond-shaped box. Its default colour is green, and is configurable in the Options window.
	Files that could not be found during processing are represented by a dotted oval.
	Dependencies between files are represented by a black arrowed line.
	Files with collapsed dependencies have a dotted outline and a grey arrowed line.

Include Graph Mouse Controls

Clicking on a file in the graph window opens that file in the Visual Studio editor. Clicking on the link between two files opens the editor on the #include line that includes the latter file from the former. By mousing over a file and then clicking the +/- icon at the edge it is possible to collapse and un-collapse it; hiding and showing its dependencies respectively.

Tooltips on the files and the links between files show the full path of the files in question.

Moving the mouse wheel up and down will zoom in and out of the graph.

Double-clicking the graph window is the same as clicking 'Zoom To Fit'; scaling the graph to fit the current window.

Dragging the background of the graph window either pans or zooms, depending on which option is selected in the Toolbar.

Right clicking on a file will bring up a context menu with options to open that file, show the paths of includes that include it, collapse the file or refresh the graph.

Options Window

In the options window you can configure graph layout and colours, change preprocessing options and view information on IncludeManager and its license.

The Graph Direction option controls the direction in which the graph is layed out. By default files start at the left hand side of the graph and progressively more included nodes are placed towards the right.

The Colours are by default blue for source files, white for header files and green for system files. Here the colours can be modified by clicking on the relevant section, which will bring up a colour picker dialog.

The Preprocessor section controls aspects of the preprocessor:

• Stop at system includes will prevent IncludeManager from displaying the dependencies of system includes. All system includes are still parsed, but system include files on the graph will be collapsed by default.

• Case sensitive determines whether IncludeManager will consider two files, whose names differ only by case, to be different. By default IncludeManager is not case sensitive.

• Use fast preprocessor is on by default, and causes IncludeManager to use a simplified method for gathering dependency information which is significantly faster than a normal preprocess. The include tree may not always be accurate with this option enabled.

The Renderer section controls aspects of the renderer:

• Compress collapsed graphs is on by default and causes the entire graph to be re-layed out every time a file is collapsed or uncollapsed. Without this option, collapsing files simply hides them from view.

• Auto-refresh graph when code changes is on by default and causes the entire graph to be updated whenever code is altered in the Visual Studio editor. When this is disabled, the view will only update when the 'Refresh' button is clicked, or 'Force Graph Refresh' is selected from the graph context menu.

The Paths options determine which file extensions IncludeManager considers in its graph-drawing when processing projects. When Ignore IDE source file info is enabled, only the source file filter is used to determine which files are to be used: By default, IncludeManager consults the IDE in addition to the source file filter.

The About button brings up the License Information window, where details of the current version of IncludeManager can be found, along with details of the license.