Project Tree panel

This panel is used to display components of the microcontroller, build tool, and source file of the project in tree view.

Figure A.7

Project Tree Panel

The following items are explained here.

-	[How to open]

-	[Description of each area]

[Toolbar]

-	[[Edit] menu (Project Tree panel-dedicated items)]

-	[[Help] menu (Project Tree panel-dedicated items)]

-	[Context menu]

[How to open]

-	From the [View] menu, select [Project Tree].

[Description of each area]

(1)	Project tree area

Project components are displayed in tree view with the following given node.

When each component (the node or file) is selected, the detailed information (property) is displayed in the Property panel. You can change the settings.

Node

Explanation

Project name (Project)

(Subsequently called "Project node")

The project's name.

Microcontroller name (Microcontroller)

(Hereafter referred to as "Microcontroller node")

The microcontroller used in the project.

Boot Loader (Configuration Tool for Multi-core) [RH850]

(Hereafter referred to as "Configuration Tool for Multi-core node")

The node for setting application projects which configure a project for multi-core.

Note that this node is shown when the project type is a boot loader project.

Design Tool name (Design Tool)

(Hereafter referred to as "Design Tool node")

The design tool (pin configurator, code generator, smart configurator [RX][RL78], etc.) used.

Note that Code Generator (Design Tool) node is not shown when the project type is a debug-dedicated project.

Build tool name (Build Tool)

(Hereafter referred to as "Build Tool node")

The build tool (compiler, assembler, etc.) used.

When the project type is a debug-dedicated project, "None" is shown as build tool name.

Debug tool name (Debug Tool)

(Hereafter referred to as "Debug Tool node")

The debug tool (in-circuit emulator, simulator, etc.) used.

Program Analyzer (Analyze Tool)

(Hereafter referred to as "Analyze Tool node")

The analyze tool used.

Note that this node is not shown when the project type is a debug-dedicated project.

File

(Hereafter referred to as "File node")

Files registered to the project are displayed directly below the File node.

Download files

(Hereafter referred to as "Download files node")

This is a node for adding download files to the project.

Note that this node is shown only when the project type is a debug-dedicated project.

Build tool generated files

(Hereafter referred to as "Build tool generated files node")

This node is created during a build. Files created by the build tools are displayed directly below the node (except for object files). This node is always shown under the File node.

Displayed files cannot be renamed, deleted, or moved.

This node is always displayed below the File node.

This node will no longer appear if you reload the project after building.

Note that this node is not shown when the project type is a debug-dedicated project.

Startup [RL78]

(Hereafter referred to as "Startup node")

This is a node for adding other than standard startup files to the project. This node is always shown under the File node.

Note that this node is not shown when the project type is a debug-dedicated project.

Category name

(Hereafter referred to as "Category node")

These user-defined categories are used to classify files into modules (see "").

Note that this node is always shown under the files node.

Subproject name (Subproject)

(Hereafter referred to as "Subproject node")

Subprojects added to the project.

Remark 1.

Only the tools corresponding to the microcontroller in use are shown.

Remark 2.

When more than one component are selected, only the tab that is common to all the components is displayed.
When more than one file are selected and their common properties are different, that field is left blank.

Remark 3.

See "E. USING AN EXTERNAL BUILD TOOL" for details on a debug-dedicated project.

This area has the following functions.

(a)	Import project files

If you drag the project file from the windows explorer and drop in this area, you can open the project in Main Window.

(b)	Add subprojects

You can add subprojects by one of the following procedure.

<1>	Add an existing subproject

-	Select Project node or Subproject node. Then select [Add] >> [Add Subproject...] in [File] or [Project] menu. Add Existing Subproject dialog box appears. Select subproject files to add.

-	Select [Add] >> [Add Subproject...] in the context menu of Project node or Subproject node. Add Existing Subproject dialog box appears. Select subproject files to add.

<2>	Add new subproject

-	Select Project node or Subproject node. Then select [Add] >> [Add New Subproject...] in [File] or [Project] menu. Create Project dialog box appears. Create a new subproject file.

-	Select [Add] >> [Add New Subproject...] in the context menu of Project node or Subproject node. Create Project dialog box appears. Create a new subproject file.

(c)	Remove a subproject from a project

You can remove a subproject from a project by one of the following procedure.

-	Select the subproject that you want to delete, then select [Remove from Project] in [Project] menu.

-	Select the subproject that you want to delete, then select [Remove from Project] in the context menu.

Caution

If the selected subproject is the active project, then it cannot be removed from the project.

(d)	Move subprojects

You can move subprojects by the following procedure.

-	Drag the subproject you want to move, then drop it in the destination.

Remark

You can run multiple CS+ and drop the subproject to a different project. In this case, the dropped subproject is copied, not moved.

(e)	Select multiple nodes

You can select multiple nodes in sequence by the following procedure.

-	Click or place the cursor on the start node then click with pressing the [Shift] key or place the cursor on the end node.

You can select multiple nodes one by one by the following procedures.

-	Click on the node with pressing the [Ctrl] key.

-	Place the cursor key on the node with pressing the [Ctrl] key then press [Space] key.

(f)	Expand/collapse a node

You can expand the selected node by the following procedure.

-	Select the node and then press the [*] key.

You can collapse the selected node by the following procedure.

-	Select the node and then press the [Shift] + [*] key.

(g)	Adding a file

You can add a file by one of the following procedures.

The files are added below the File node.

<1>	Adding an existing file

-	Select either one of the Project node, Subproject node, File node or a file. Then select [Add] >> [Add File...] from the [File] menu. The Add Existing File dialog box will open. Select the file to be added.

-	Select either one of the Project node, Subproject node, File node. Then select [Add] >> [Add File...] from the context menu. The Add Existing File dialog box will open. Select the file to be added.

-	Copy the file using such as Explorer and then point the mouse to this area. Select [Paste] from the [Edit] menu.

-	Drag a file using such as Explorer and drop it onto the location in this area where you want to add it to.

Remark

If you drag the file using such as Explorer and drop it onto the empty space below the lower project tree, it is assumed that you have dropped it onto the Main project.

<2>	Adding a new file

-	Select either one of the Project node, Subproject node, File node or a file. Then select [Add] >> [Add New File...] from the [File] menu. The Add File dialog box will open. Designate the file to be created.

-	Select either one of the Project node, Subproject node, File node. Then select [Add] >> [Add New File...] from the context menu. The Add File dialog box will open. Designate the file to be created.

Remark

A blank file is created at the location designated in the Add File dialog box.

(h)	Removing a file from the project

You can remove a file from the project by one of the following procedures.

The file itself is not deleted from the file system.

-	Select the file you want to remove from the project and then select [Remove from Project] from the [Project] menu.

-	Select the file you want to remove from the project and then select [Remove from Project] from the context menu.

(i)	Moving a file

You can move a file by the following procedure.

The file is moved below the File node.

-	Drag the file you want to move and then drop it onto the destination.

Remark 1.

If you drop the file in the main project or subproject, the individual options set in the file are retained.

Remark 2.

If you drop the file between the different projects, or onto the main project or subproject in same project, the file is copied, not moved.
Note that the individual option set in the file is not retained.

(j)	Adding a category

You can add a category node by one of the following procedures.

The category node is added below the File node.

-	Select [Add New Category] from the [Project] menu.

-	Select [Add New Category] from the context menu of either one of the Project node, Subproject node, or File node.

Remark 1.

The default category name is "New category".

Remark 2.

You can also add a category node with the same name as the existing category node.

(k)	Moving a category

You can move a category node by the following procedure.

The category node is moved below the File node.

-	Drag the category node you want to move and then drop it onto the destination.

Remark 1.

If you drop the category node in the main project or subproject, the individual options set in the file in the category node are retained.

Remark 2.

If you drop the category node between the different projects, or onto the main project or subproject in same project, the category node is copied, not moved.
Note that the individual option set in the file in the category node is not retained.

(l)	Adding a folder

You can add a folder using such as Explorer by the following procedure.

The folder is added below the File node.

The folder is added as a category.

-	Drag the folder using such as Explorer and drop it onto the destination. The Add Folder and File dialog box will open. Specify the file types and subfolder levels in the folder to be added.

Caution

You cannot drag and drop a folder and file onto this area simultaneously.

(m)	Displaying the dependency file

When there is a dependency file for a source file added to the project, the dependency file is displayed under the source file.

The source file without a dependency file

The source file with a dependency file

The display of the dependency files is updated on the following timings:

-	When the first build is run after the project is loaded

-	When on the toolbar is clicked

-	When [Update Dependencies] is selected from the [Build] menu

-	When [Update Dependencies of active project] is selected from the [Build] menu

Remark 1.

This function is valid only when the [Show dependency files in project tree] check box in the [General - Build] category of the Option dialog box is selected.

Remark 2.

Information on the dependency files displayed on the project tree is not saved in the project file.

(n)	Displaying the editing file

When the file added to the project is edited in the Editor panel (exclude the dependency files) and the file is not saved once, the file name is followed by "*".

If the file is saved, "*" will be deleted.

The file that is saved
The file that is not saved after editing

(o)	Displaying the source file in boldface that the individual build option is set

The source file icon whose option is different from the project general options (individual compile options or individual assemble options) is changed to the different one from the normal icon.

The file with project general options
The file with the individual build options

(p)	Highlighting the file with the read-only attribute

The read-only file added to the project is displayed in italic.

The file without the read-only attribute
The file with the read-only attribute

(q)	Highlighting the file that does not exist

The file that is added to the project but does not exist is grayed out and its icon is dimmed.

The file that exists
The file that does not exist

(r)	Highlighting the build-target file

<1>	The file which an error occurred during building (rapid building), rebuilding, compiling or assembling is highlighted as the example below.

The file without errors or warnings
The file with an error
The file with a warning

Remark 1.

The file with both an error and a warning is highlighted in red.

Remark 2.

The highlight is canceled when the build option (general option or individual option) or the build mode is changed.

<2>	The names of the following files are displayed in boldface.

-	The source file that has not been compiled after editing

-	The source file after a clean has been executed

-	The source file after the build tool option has been changed

-	The source file after the build mode has been changed

Remark

The file names are all displayed in boldface right after the project is opened. The boldface display is canceled after a build is executed.

(s)	Highlighting the non build-target file

The file that is set as non build-target is highlighted as shown in the example below.

Build-target file
Non build-target file

(t)	Highlighting overlay icons

Overlay icons of Windows Explorer set in a project, a file added to the project, and a category (only when a shortcut to the folder is set) is displayed on the left side of the ordinal icon as the example below.

The project that has not been changed
The project displaying an overlay icon

Caution

The above overlay icon is provided as a sample.
Note that an icon to be displayed differs depending on the tools in use.

The display of overlay icons is updated on the following timings:

-	When the project is loaded

-	When on the toolbar is clicked

-	When [Refresh] is selected from the [Edit] menu

Remark

This function is valid only when this product is activated while the [Show overlay icons for Windows Explorer in project tree] check box in the [General - Display] category of the Option dialog box is selected.

(u)	Highlighting the category in which a shortcut to a folder is set

The category in which a shortcut to a folder is set is highlighted as shown in the example below.

Ordinal category
Category in which a shortcut to a folder has been set

(v)	Highlighting the project that has been changed

The file component that is added to the project and the property of the project component are changed, the project name is followed by "*" and is displayed in boldface.

The boldface is canceled when the project is saved.

The project that has not been changed
The project that has been changed

(w)	Highlighting the active project

The active project is underlined.

Non-active project
Active project

(x)	Updating the status of file highlighting

The state of highlighting for files, read-only files, non-existent files, and overlay icons is updated by the following procedure.

-	Select on the toolbar.

(y)	Running the editor

The file with the specific extension is opened in the Editor panel. When an external text editor is set to be used in the Option dialog box, the file is opened with the external text editor that has been set. Other files are opened with the applications associated by the host OS.

Caution

The file with the extension that is not associated with the host OS is not displayed.

You can open the editor by one of the following procedures.

-	Double click the file.

-	Select a file and then select [Open] from the context menu.

-	Select a file and then press the [Enter] key.

[Toolbar]

Sorts files and Category nodes in Project tree area in order of their names.

: Ascending order

: Descending order

: Ascending order

Sorts files in Project tree area in order of the time stamp.

: Descending order

: Ascending order

: Descending order

Sorts files (other than the dependency files) and Category nodes in Project tree area in order of the user definition (default).

Display order is changed by dragging and dropping the file and Category node.

Refreshes the state of highlighting for files, read-only files, non-existent files, and overlay icons.

[[Edit] menu (Project Tree panel-dedicated items)]

Copy

Copies the selected file or Category node to the clip board.

While editing the file name or the category name, the characters of the selection are copied to the clip board.

Note that this menu is only enabled when the file (other than the dependency files) or the Category node is selected.

Paste

Inserts the contents of the clip board to the root of the node that is selected on the Project Tree.

While editing the file name or the category name, insert the contents of the clip board.

Note that this menu is only enabled when the file or the Category node exists. If a project with the same contents is already on the clipboard, however, then if multiple files or Category nodes are selected, and the build tool is running, then it will be invalid.

Rename

You can rename the selected project, subproject, file, and Category node. Press [Enter] key to confirm the rename. Press the [ESC] key to cancel.

When the project, subproject, or file is selected, the actual file name is also changed.

When the selected file is added to other project, those file names are also changed.

Note that this menu is only enabled when the project, subproject, file (other than the dependency files), and Category node is selected. Note that rename is disabled when the build tool is operating.

[[Help] menu (Project Tree panel-dedicated items)]

Open Help for Project Tree Panel

Displays the help of this panel.

[Context menu]

(1)	When a Project node is selected

Build Actively project		Builds the active project. If the active project is the main project, its subproject is not built. When a dependent project is set for the active project, a build of the dependent project is also run. Note that this menu is disabled when the build tool is in operation.
Rebuild Actively project		Rebuilds the active project. If the active project is the main project, its subproject is not rebuilt. When a dependent project is set for the active project, a rebuild of the dependent project is also run. Note that this menu is disabled when the build tool is in operation.
Clean Actively project		Cleans the active project. If the active project is the main project, its subproject is not cleaned. Note that this menu is disabled when the build tool is in operation.
Open Folder with Explorer		Opens the folder that contains the project file of the selected project with Explorer.
Windows Explorer Menu		Displays the Windows Explorer menu corresponding to the project file for the selected project.
Add		Shows the cascading menu to add subprojects and files to the project.
	Add Subproject...	Opens the Add Existing Subproject dialog box to add the selected subproject to a project.
	Add New Subproject...	Opens the Create Project dialog box to add the created subproject to a project.
	Add File...	Opens the Add Existing File dialog box to add the selected file to a project.
	Add New File...	Opens the Add File dialog box to create a file with the selected file type and add to a project. The added file can be opened with the application corresponds to the file extension.
	Add New Category	Adds a new Category node to the root of the File node. This allows the category name to be changed. The default category name is "New category". The new category name can be changed to the same name as the existing Category node. Note that this menu is disabled when the build tool is in operation.
Set Selected project Active Project		Sets the selected project to an active project.
Save Project and Development Tools as Package		Saves a set of the project and this product by copying them in a folder.
Paste		This menu is always disabled.
Rename		You can rename the selected project.
Property		Displays the selected project's property in Property panel.

(2)	When a Subproject node is selected

Build Actively project		Builds the active project. When a dependent project is set for the active project, a build of the dependent project is also run. Note that this menu is disabled when the build tool is in operation.
Rebuild Actively project		Rebuilds the active project. When a dependent project is set for the active project, a rebuild of the dependent project is also run. Note that this menu is disabled when the build tool is in operation.
Clean Actively project		Cleans the active project. Note that this menu is disabled when the build tool is in operation.
Open Folder with Explorer		Opens the folder that contains the subproject file of the selected subproject with Explorer.
Windows Explorer Menu		Displays the Windows Explorer menu corresponding to the subproject file for the selected subproject.
Add		Shows the cascading menu to add subprojects, files, and Category nodes to the project.
	Add Subproject...	Opens the Add Existing Subproject dialog box to add the selected subproject to a project. The subproject cannot be added to another subproject.
	Add New Subproject...	Opens the Create Project dialog box to add the created subproject to a project. The subproject cannot be added to another subproject.
	Add File...	Opens Add Existing File dialog box to add the selected file to a project.
	Add New File...	Opens the Add File dialog box to create a file with the selected file type and add to a project. The added file can be opened with the application corresponds to the file extension.
	Add New Category	Adds a new Category node to the root of the File node. This allows the category name to be changed. The default category name is "New category". The new category name can be changed to the same name as the existing Category node. Note that this menu is disabled when the build tool is in operation.
Set Selected subproject Active Project		Sets the selected subproject to an active project.
Remove from Project		Removes the selected subproject from the project. The subproject file itself is not deleted from the file system with this operation. When the selected subproject is the active project, it cannot be removed from the project. Note that this menu is disabled when the build tool is in operation.
Paste		This menu is always disabled.
Rename		You can rename the selected subproject.
Property		Displays the selected subproject's property in Property panel.

(3)	When a Microcontroller node is selected

Change Microcontroller...

Opens the Change Microcontroller dialog box to change the microcontroller.

When multiple Microcontroller nodes for the projects using the same microcontroller are selected, the microcontroller settings can be changed at one time.

Property

Displays the selected microcontroller's property in Property panel.

(4)	When a Build Tool node is selected

Build Project		Runs a build the selected project (main project or subproject). A build of a subproject is also run when it is added in the project. Note that this menu is disabled when the build tool is in operation.
Rebuild Project		Runs a rebuild the selected project (main project or subproject). A rebuild of a subproject is also run when it is added in the project. Note that this menu is disabled when the build tool is in operation.
Clean Project		Runs a clean of the selected project (main project or subproject). A clean of a subproject is also run when it is added in the project. Note that this menu is disabled when the build tool is in operation.
Set to Default Build Option for Project		Sets the current build options as the standard for the project. When a subproject is added, its setting is not made. When the build option that is different from the standard option is set, its property is displayed in boldface.
Import Build Options...		Opens the Import Build Options dialog box to import the build options from the selected project file.Note
Set Link Order...		Opens the Link Order dialog box to display object module files and library files to and set their link orders. Note that this menu is disabled when the build tool is in operation.
Property		Displays the selected build tool's property on the Property panel.

Note	See "2.7.1 Import the build options of other project" for details about the import function of the build options.

(5)	When a Download file node is selected

This node is displayed only for a debug-dedicated project (see "E. USING AN EXTERNAL BUILD TOOL").

Add		Shows the cascading menu to add download files to the project.
	Add File...	Opens the Add Existing File dialog box to add the selected file to the project as a download file.
	Add New File...	Opens the Add File dialog box to create a file with the selected file type and add to the file to the project as a download file.
	Add New Category	Adds a new Category node directly below this node. This allows the category name to be changed. Up to 200 characters can be specified. The default category name is "New category". You can also add a Category node with the same name as the existing Category node. This menu is disabled when the build tool is in operation and when categories are nested 20 levels.
Open Folder with Explorer		This menu is always disabled.
Windows Explorer Menu		This menu is always disabled.
Remove from Project		This menu is always disabled.
Copy		This menu is always disabled.
Paste		Inserts the contents of the clipboard directly below this node. However, this menu is disabled when the contents of the clipboard exist in the same project.
Rename		This menu is always disabled.
Property		Displays this node's property on the Property panel.

(6)	When the File node is selected

Add		Shows the cascading menu to add files and Category nodes to the project.
	Add File...	Opens the Add Existing File dialog box to add the selected file to the project. The file is added directly below this node. The added file can be opened with the application corresponds to the file extension.
	Add New File...	Opens the Add File dialog box to create a file with the selected file type and add to the file to the project. The file is added directly below this node. The added file can be opened with the application corresponds to the file extension.
	Add New Category	Adds a new Category node directly below this node. This allows the category name to be changed. Up to 200 characters can be specified. The default category name is "New category". You can also add a Category node with the same name as the existing Category node. This menu is disabled when the build tool is in operation and when categories are nested 20 levels.
Open Folder with Explorer		This menu is always disabled.
Windows Explorer Menu		This menu is always disabled.
Remove from Project		This menu is always disabled.
Copy		This menu is always disabled.
Paste		Inserts the contents of the clipboard directly below this node. However, this menu is disabled when the contents of the clipboard exist in the same project.
Rename		This menu is always disabled.
Property		Displays this node's property on the Property panel.

(7)	When a file is selected

Compile		Compiles the selected C source file. This menu is only displayed when a C source file (except a non build-target file) is selected. Note that this menu is disabled when the build tool is in operation.
Assemble		Assembles the selected assembly source file. This menu is only displayed when an assembly source file (except a non build-target file) is selected. Note that this menu is disabled when the build tool is in operation.
Execute in Python Console		Opens the Python Console panel to execute the selected Python script file. This menu is displayed only when a Python console script file is selected.
Open		Opens the selected file with the application corresponds to the file extension (see "(g) Adding a file").
Open with Internal Editor...		Opens the selected file with the Editor panel.
Open with Selected Application...		Opens the Open with Program dialog box to open the selected file with the designated application.
Open Folder with Explorer		Opens the folder that contains the selected file with Explorer.
Windows Explorer Menu		Displays the Windows Explorer menu corresponding to the selected file.
Add		Shows the cascading menu to add files and Category nodes to the project.
	Add File...	Opens the Add Existing File dialog box to add the selected file to the project. The file is added to the same level as the selected file.
	Add New File...	Opens the Add File dialog box to create a file with the selected file type and add to the file to the project. The file is added to the same level as the selected file. The added file can be opened with the application corresponds to the file extension.
	Add New Category	Adds a new Category node at the same level as the selected file. You can rename the category. Up to 200 characters can be specified. The default category name is "New category". You can also add a Category node with the same name as the existing Category node. This menu is disabled when the build tool is in operation and when categories are nested 20 levels.
Remove from Project		Removes the selected file from the project. The file itself is not deleted from the file system. Note that this menu is disabled when the build tool is in operation.
Copy		Copies the selected file to the clipboard. When the file name is in editing, the selected characters are copied to the clipboard.
Paste		This menu is always disabled.
Rename		You can rename the selected file. The actual file is also renamed. When the selected file is added to other project, that file name is also changed.
Change Extension...		Opens a message dialog box to confirm whether to change the file extension. Clicking on the [Yes] button in the dialog box will open the Character String Input dialog box, in which the extension of the selected file can be changed. When multiple files are selected, they are changed at one time. Note that this menu item is disabled if the name of the selected file cannot be changed or the file cannot be removed from the project, or the build tool is in operation.
Property		Displays the selected file's property on the Property panel.

(8)	When the Build tool generated files node is selected

Property

Displays this node's property on the Property panel.

(9)	When a Category node is selected

Add		Shows the cascading menu to add files and Category nodes to the project.
	Add File...	Opens the Add Existing File dialog box to add the selected file to the project. The file is added directly below this node. The added file can be opened with the application corresponds to the file extension.
	Add New File...	Opens the Add File dialog box to create a file with the selected file type and add to the file to the project. The file is added directly below this node. The added file can be opened with the application corresponds to the file extension.
	Add New Category	Adds a new Category node directly below this node. This allows the category name to be changed. Up to 200 characters can be specified. The default category name is "New category". You can also add a Category node with the same name as the existing Category node. This menu is disabled when the build tool is in operation and when categories are nested 20 levels.
Open Folder with Explorer		Opens a shortcut to the folder that has been set for the selected category in the Explorer. This menu item will be invalid if a shortcut to the folder has not been made.
Windows Explorer Menu		Shows the Windows Explorer menu for a shortcut to the folder that has been set for the selected category. This menu item will be invalid if a shortcut to the folder has not been made.
Remove from Project		Removes the selected Category node from the project. Note that this menu is disabled when the build tool is in operation.
Copy		Copies the selected Category node to the clipboard. When the category name is in editing, the characters of the selection are copied to the clipboard.
Paste		Inserts the contents of the clipboard directly below this node. However, this menu is disabled when the contents of the clipboard exist in the same project. When the category name is in editing, the contents of the clipboard are inserted.
Rename		You can rename the selected Category node.
Property		Displays the selected Category node's property on the Property panel.

Remark 1.

When more than one component are selected, the context menu of the last selected component is displayed.

Remark 2.

The context menu of the currently selected component is displayed in the blank area under the project tree.