Code Navigation

Atelier provides several ways to navigate to classes, class members, and other important components of your source code.

Outline View

The Outline view shows the logical structure of the class or routine file selected in the Atelier editor. You can navigate to an item in the editor by selecting it in the Outline view. When you edit a file, the Outline view reflects your position in the editor and updates as you edit. The following image shows the outline view to the right of the editor area. The user has just navigated to the method Greeting by clicking on it in the outline view.

Outline view

To open the Outline view, select Opens Outline view Window > Show View > Other... > General > Outline from the main menu, or select Show In > Outline in the Editor context menu.

Quick Outline

The Quick Outline provides essentially the same information as the Outline view, with a lighter-weight interface. Press CTRL+O or select Quick Outline from the editor context menu to open an in-place outline of the content of the source file. Press CTRL+O again to show inherited members. You can navigate to the definition of any item in the list by clicking on an it. The following image shows the quick outline dialog with inherited members visible:

Quick outline

Type Hierarchy View

Atelier provides an initial implementation of the Eclipse Type Hierarchy view. Select a class file in the Atelier Explorer, right-click to open the context menu and select Open Type Hierarchy:

Open type hierarchy

The left side of this view shows you the super classes of the selected class. The right side shows class members:

type hierarchy view

Select the Lock View and Show Members in Hierarchy button in the toolbar of the member area, then select run(). The view now shows all the types that implement run().

lock and show members

In the Type Hierarchy view select PrintMessage, right-click and select Focus On 'PrintMessage' from the context menu. The Type Hierarchy view now shows the hierarchy for PrintMessage. You can use the Previous Type Hierarchies button (Previous Type Hierarchies) button to return to a hierarchy you have viewed prevously.

Double-clicking on an item in the Type Hierarchy view opens the class file in the editor. Double-clicking on a class member opens the corresponding file at the declaration for that member.

Go To Line

The Go to Line... command lets you navigate to a specific line in a file open in the editor. Open the dialog by selecting Navigate > Go to Line... from the main menu, or use the keyboard shortcut CTRL+L. Enter a line number or tag, plus an optional offset. In a class file, a tag can be the name of a class member. In a routine file, it can be a label. The offset specifies the number of lines past the location of the label. For example, the tag plus offset in the following screen shot specifies line 31, 5 lines past the location of TopCategory.

Go to line

When you type a label, a list opens that is filtered by what you have typed:

Go to line

View Other Code

Select View Other Code from the editor right-click context menu to open intermediate files created during compilation so you can view the generated code. You can also click the View Other Code toolbar button View Other Project. Intermediate files are created on the server during compilation, and they are stored on the server. Such files open with a background color that indicates they have been opened on the server in read-only mode. If you need to edit an intermediate file, you must first copy it to the project in the workspace, using the Copy to Project command on the Sever Explorer context menu.

The Compilation preference Keep generated source code (k) must be selected in order to retain the generated files. See the topic on Compilation Preferences. It is selected by default.

Open Declaration

Click on the name of a class, method, or property. You can then right-click to open a context menu and select Open Declaration, which navigates to the declaration of the object, opening the file if necessary.

Open Atelier Class/Routine

Select Navigate > Open Atelier Class/Routine from the main menu, click on the icon Interactive search in the main toolbar, or use the keyboard shortcut CTRL+SHIFT+T. The dialog box that opens lets you search for classes or routines in a namespace on a server connection and in Atelier projects open in the workspace.

Use the downward-facing triangle in the upper-right corner of the dialog to view a drop-down list of options:

Open class/routine drop-down list

The first items in the list control view and scope:

The ramaining items list namespaces available on existing connections. Select the connection/namespace pairs that you want to search.

The dialog initially lists all classes and routines in the selected namespaces and in any projects open in the workspace. You can filter the list by typing in the selection field. You can enter a class or routine name, using wildcard characters ? for any single character and * for any string. The following screen shot shows a filtered list.

Open class/routine filtered list

Select an item and click OK to open it in the editor.

Navigation Forward and Back

You can use the Back, Forward, and Last Edit Location items on the Navigate menu to move between locations in code files you have visited. You can also use the forward Previous file, back Next file and last edit location Last edit location buttons on the main toolbar.

Server Search

You can search on the server using the Atelier search tab. Click on an item in the results list to navigate to that code on the server. See Atelier Search Tab.

Open Resource

The Open Resource dialog allows you to browse the workbench for a file to open in an editor.

Related Eclipse

Outline view
Using quick views
Viewing the type hierarchy

Related concepts

Atelier Editor
Atelier Views
Atelier Perspectives
Atelier Search Tab

Related reference

Server Explorer View
Compilation