Contents | Previous | Next

# General Source-Navigator Features

This chapter describes the most commonly used features of Source-Navigator.

## Menus

The File, Edit, Search, and Tools menus appear in all windows, however they are context-sensitive: the options available from the menus change depending upon which tool you're using. The History and Windows menus, however, are more general and offer the same options within each tool.

### History Menu

The History menu enables you to repeat queries and restore previous states of each browser.

History Menu

### Windows Menu

The Windows menu contains the tools available in Source-Navigator.

Windows Menu

To add a new tool in a view, from the Windows menu, select New View. To add a tool to your current window, from the Window menu, select Add View. To change to a currently running instance of a tool, from the Windows menu, select Open Views.

## General Window Features

You may reuse Source-Navigator windows and adjust the window column size. The status line shows information such as the number of lines of source code in the Editor window and the current directory.

### Adding a Browser to an Existing Window

If you find yourself often using two Source-Navigator tools simultaneously, you can combine them into one window. This keeps you from constantly switching between windows, and allows you to see both tools at the same time.

For instance, if you have a class open in the Cross-Reference Browser and you want to bring up an Editor to see the same class, but you want to continue to see the cross-references, from the Windows menu select Add View -> Editor, and an Editor will appear in the same window. Depending upon your settings in the Preferences dialog (see Window), the new Editor appears either at the bottom of the window (Vertical) or on the right side of the window (Horizontal).

Vertical Windows

Horizontal Windows

As you click on symbols in the Cross-Reference Browser, those symbols appear in the Editor.

### Reusing Windows

Selecting the Reuse button from a window's status line, overwrites the window's contents. With Reuse deselected, a new window is created to display the new view.

For example, with Reuse deselected, double-clicking a symbol to display its symbol definition opens a new Editor window. Your previous Editor window remains unchanged. Reuse is selected by default.

### Preserving Context Between Windows

Selecting the Context button from a window's status line preserves the context of a selected symbol when you switch between tools.

If Context is deselected, the new tool opens to the default or empty condition.

For example, if a particular class is selected in the Editor, the same class is displayed when you change to the Class Browser. Context is selected by default. When Context is not selected, the Class Browser opens with whatever was previously displayed.

### Adjusting Window Column Size

The column dividers allow you to adjust the width of columns on the screen. You can adjust the size of a column by moving your cursor over the divider until the left-right arrows appear, then clicking and dragging the column divider to the desired position.

## Using Filters

Source-Navigator provides several ways to filter the symbols displayed in the Symbol Browser. You can:

- use the List Filter buttons (see List Filter buttons).

- use the Symbol Selectors from the View menu.

- use Column Filters (see Column Filters).

- use the Symbol Accelerator combo-box (see Symbol Accelerator Combo-box).

### Symbol Selectors

Although the List Filter buttons allow you to search by classes, methods, functions, and project files, the Symbol Selector provides a more complete list of search choices. In the Symbol Browser window, from the View menu, select Symbol Selectors.

Symbol Selectors Menu

If the Exclusive Search box is selected, you may choose only one symbol type to search for; if it's deselected, you may combine symbol types for more complex searches.

### Pattern Box

In large projects, thousands of symbols may be listed in any list view. To list a subset, or to restrict a symbol list, use the Pattern search filed. When text is typed in this field, the list updates to show only the symbols or components matching that pattern. For instance, when Variables is selected in the Symbol Browser or Symbol Accelerator, typing `*gv*` in the Pattern: field shows all global variables in the file or project. See Symbol and Type Abbreviations for a list of pattern abbreviations.

The Pattern text box allows you to search in a tool for a particular pattern. Patterns are not case sensitive.

Pattern Interpretation of Special Characters

Special Character | Interpretation in Filter or Pattern Boxes
--- | ---
`*` | Matches any sequence of zero or more characters.
`?` | Matches a single character.
`[chars]` | Matches any single character in `chars` . If `chars` contains a sequence of the form `c-x`, any character between `c` and `x` inclusive will match.
`\?` | Matches the `?` character exactly, avoiding special interpretation of the character. Also applies to the following characters: `[`, `]`, `*`, `?`, and `\`.

For example, `*.[hc]` matches all strings with `*.C`, `*.H`, `*.c`, and `*.h` extensions; `[0-9]*` matches all symbols beginning with a number.

With `Agent*` entered into the Pattern text box, and Classes, Methods, and Files chosen from the View menu, you would see the results shown in Symbol Browser Showing Filter Results.

Symbol Browser Showing Filter Results

To clear the text box for another search, type Ctrl+U.

## Symbol and Type Abbreviations

Source-Navigator uses the following abbreviations, which are accessible from the Help menu by selecting Abbreviations.

Abbreviations Panel

## Printing from Source-Navigator

To print the contents of Source-Navigator browsers, such as the Editor or Cross-Reference Browser, from the File menu, select Print. The print dialog box varies with different printers, printer drivers, and platforms.

### Print Dialog (UNIX)

UNIX Print Dialog

The default command line shown in the Printer command text box is set from the Others tab of the Project Preferences dialog (see Others tab).

Choose Selection to print only the highlighted portion of the file (if you do not highlight any part of the file, the entire file is printed).

Choose All to print the entire file.

### Print Dialog (Windows)

Windows Print Dialog

##### Printer

Name

Choose the name of the desired printer.

Print to file

Check this box to print to a file.

### Note

If you choose Print to file, a dialog box appears after clicking OK. Type the desired filename (alone or with a path to a specific directory) in the Output File Name text box and click OK.

If you enter the filename without a path, your file is saved in the same directory as the project file.

##### Print range

All

Prints the contents of the entire file.

Selection

Prints only the highlighted portion of the file. If you do not highlight any part of the file, the entire file is printed.

##### Copies

Number of copies

Choose the number of copies to print.

Windows Document Properties Dialog

The options in this dialog box depend on which printer you have selected, but usually include paper size, orientation, and duplex printing. For more information on these options, see your printer documentation.

Contents | Previous | Next