Project Desktop
Overview
The Project Desktop provides a visual representation of a project.
It includes Menu Bar, Tool Bar, one or more Project Views,
Drop Site Bar and the Status Bar.
Project View
The Project View contains a three folders with different types of subview.
It is now easy to reorganize the look of your project using a few mouse clicks !
Dependency Tree
The Dependency Tree folder contains a hierarchical list of project components.
It is the standard element of interface.
The complete project structure and status of each item can be seen from this list.
Dependency Tree always includes at least two folders:
- Root Folder - for all folders, macros and targets of this project.
- Includes Folder - obligatory folder for the alphabetically list of the all included files.
An any file in this tree can be found by selecting Find in the Actions menu or by pressing Ctrl+F shortcut keys.
This will bring up the Find Node dialog.
In a huge projects, where is a lot of different targets and macros it is very useful to use Virtual Folders.
Drag'n'Drop Operations
Note: All Drag'n'Drop operations in C-Forge are performed by Mouse Button 2 (Middle mouse button).
Dependency Tree management operations:
- Rearrange nodes:
To change any node position at one tree level, Drag'n'Drop (Btn2) any node to parent node or to corresponding position at the same level.
- Move nodes:
To change the target or folder node parent, Shift+Btn2 Drag'n'Drop it to new folder.
- Link nodes:
To link (copy) any node to other, Ctrl+Shift+Btn2 Drag'n'Drop it to new target node.
Note: The deletion of linked nodes (except folders) is not removes the source node of link.
Working Area (Working Files Desktop)
The Working Area (also known as Working Files Desktop) contains a list of files, sorted by name, that are presently being modified.
Files are added or removed from this list using Drag'n'Drop operations to Drop Sites or corresponding elements of popup menus.
When a file is placed in the Working Area it is locked and no other users can modify it.
Pressing Enter on a selected file node or double-clicking on it will open the file in the Editor Window.
Disk
The Disk panel contains a view on the file system.
Using Drag'n'Drop it is possible to simply add sources and includes to Dependency Tree and manipulate files on disk.
Note: dragging a file(s) from this view to the target icon in the Dependency Tree opens the Add Node(s) dialog.
Popup menu:
- Create - creates an object in currently selected directory:
- Project Source - creates new file and adds it as source to current target.
- Project Include - creates new file and adds it as include to current project
- Directory - creates new directory.
- File - creates new file.
- Update - updates this Disk view.
- Brief/Full info - sets the Brief/Full type of files list viewing.
- Filter - sets the filter for files.
- Orientation - changes the placement (vertical/horizontal) of directory tree.
- Edit - edits the current file.
- View - views the current file.
- Print - prints the current file.
- Touch - touches the current file.
- Remove - removes the current file.
- Information - shows all information about current file.
It is possible to apply a command to multiple files by selecting them via box-select and/or click/shift-click/ctrl-click.
Menu
File
- Save - writes the changes made in the project to a disk.
- Info - calls up Project Information dialog.
- Hide Project - all windows of current project minimizes into one icon.
- Close - closes the project.
View
- Sort - sorts all items of Dependency Tree.
- Small/Large Icons - changes size of icons in Dependency Tree.
Small icons are very useful for low resolution display modes.
- Add new view - adding new Project View.
- Remove current view - removes current Project View.
- Change orientation - changes orientation (horizontal/vertical) of all Project Views.
- Split Dependency Tree - splites the current Dependency Tree.
- Unsplit Dependency Tree - unsplites previous splited Dependency Tree.
- Brief/Full info - changes the view mode of Disk Tree.
- Disk Filter - sets a new filter for Disk Tree.
- Disk Panels Orientation - changes the placement (vertical/horizontal) of directory tree for Disk Tree.
Actions
- New
- Remove
- Remove Node - deletes the node and its files; if more then one file will be deleted, C-Forge displays the Delete Files dialog.
- Remove Disk Dependency(s) - deletes the objects and target files (if exists) for selected node; if one or more files will be deleted, C-Forge displays the Delete Files dialog.
- Touch - changes the modification time of the node file to the current time.
- Find - opens the Find dialog that allows searching nodes in the Dependency tree.
- Edit Text - opens the file in an Editor Window in read/write mode.
- View Text - opens the file in an editor window in read-only mode.
- Print Text - prints the selected file to printer.
- Place Into Revision Control - places the file into RCS.
- Version Tool - launches the Revision Control Tool for the selected file.
- Diff Tool - launches the Difference Tool.
- Grep Tool - launches the Grep Tool.
- Target Actions - opens Target Actions dialog with specified folder:
- Build Actions - actions used to build current node or target (activated by Make Node and Make Target actions).
- Exec Actions - actions, activated by double-click on current node.
- Debug Actions - actions used to debug current node (activated by Debug action).
- Node Information - displays Node information dialog with current node.
- Set Node Attributes - displays Set Node Attributes dialog for current node.
- Collect all includes - collects all includes and determines the implicit dependencies.
Build
- Make Node - makes current node (actions are depends from type of node):
- Current node is target - equal to Make Target action.
- Current node is source (have hidden dependencies) - execute default conversion for current node.
- Make Target - makes current target (actions are depends from placemen of node).
- Current node is target - makes all hidden conversions and executes Build Actions of this node,
- Current node is placed in the dependency list of target - makes target of current node.
- Run - Executes the default actions for current node (specified by Exec Actions).
- Debug - executes the Debug Actions for current target or node.
Options
Log
Tool Bar
The project desktop tool bar contains the following buttons:
- Save Project - writes the changes made in the project to a disk.
- Add Folder - opens the New Folder dialog to add a new folder.
- Add Targets - opens the Create New Target(s) dialog to add a new targets.
- Add Macro - opens the Single Value Input dialog to add a new macro.
- Add Sources - opens the Add File to Project dialog to add a new source and include files.
- Remove Node - deletes the node and its files; if more then one file will be deleted, C-Forge displays the Delete Files dialog.
- Edit Node - opens an Editor Window to edit the node file.
- Run Target - runs current target.
- Debug Target - executes the command, specified in the Debug Actions of current target.
- Make Node - makes current node.
- Make Target - makes current target.
- Tools Options - opens the Tools Options window.
The Toolbar can be toggled on and off using the Project Options dialog.
Drop Site Bar Frame
The Drop Site Frame is a group of icons, on the right side of the
Project Desktop, used to perform C-Forge commands. To use a Drop
Site drag a node and drop it into the icon matching the desired operation.
The same functionality is duplicated in menu structure. The following is
a list of the Drop Sites:

Version Tool Drop Site - launches the Revision Control Tool and displays dropped node RCS information.
If dropped node is not under the RCS, but it can be places there - works like Actions/Place Into Revision Control.

Remove Drop Site - deletes the nodes (for nodes, dragged from Dependency Tree or Disk) or discards changes (for nodes from Working Area).

Touch Drop Site - sets the time of last modifcation of the dragged nodes to current time.

Edit Drop Site - opens an Editor Window for all editable nodes.

Make Drop Site - performs the Make Node action on each droped node.
If node is folder - makes all targets in this folder.

Information Drop Site - opens the Node Information dialog first dropped node.
Status Bar
The Status Bar is used to display the type and status of the current node and project.
The busy lamp indicates the busy state of the current project during lengthy operations.
The first icon on the righthand side of the status bar indicates the editing state of selected node in the Dependency Tree.
The next site -
is displayed when RCS deposits are available for the currently selected node.
And at the last site placed the editor launch policy indicator.
- open new files in current window.
- open new files in separate (new) windows.
Clicking on the icon toggles the policy state.
As with the Tool Bar, the Status bar can be turned on/off using the Show Status Bar option found in the Project Options dialog.
Last modified: Friday, 24-Dec-1999 12:49:58 MST