Parent page: System & Environment Panels
This panel displays all projects that are currently open. Any open documents that have not been created as part of a project or added to an existing open project will also be listed.
The Projects panel is accessed in the following ways:
When you open an existing project or create a new one, its entry will appear in the Projects panel. Any existing documents that are part of a project (and any new ones that have been added) will appear under sub-folders, according to their purpose and/or type. For example, the following common folders and content document types can appear under a project:
Any documents that are independent of a project will appear as Free Documents and will appear under corresponding sub-folders.
Along with allowing multiple documents to be open for editing, the environment also supports multiple projects being open at the same time. These could be related or unrelated projects.
Documents in the Projects panel are automatically arranged in logical groups or 'folders', such as Source Documents (Schematic, PCB, etc.), Settings documents (Harness, Outjob, etc.) and, in the case of a hierarchical design, top-level schematic documents. The documents within each folder group are displayedby default in the order they were added but can be dragged and dropped to a new order position within the group.
In the case of a new hierarchical design, the parent-child relationship between documents will be displayed in the panel when the project has been compiled. Note that the connectivity relationships cannot be defined by dragging and dropping schematic documents since the inter-sheet connections and design hierarchy are in fact defined by Sheet Symbols and Port definitions.
In the panel's main tree, the active project is highlighted using the Windows Active Title Bar color for your system. When there are no documents open in the design editor window, a project is made active by selecting it from a list of all currently open (loaded) projects in the panel. As soon as a project document is opened (in an editor/viewer), the parent project of that document automatically becomes the active project.
The active document in the design editor window will also be highlighted in the panel and accompanied by the file open icon.
With numerous documents open in the design editor window, changing the active document using editor's document tabs will cause the Projects panel to update accordingly – to reflect both the active document and the active project (if the document made active does not reside in the same project as the previously active document). Conversely, clicking on the entry for a document that is already open (and that belongs to a non-active project) will make the parent project of that document the active project.
Only one project and document may be active at any given time, however the panel allows you to focus and perform actions on any project or document. Right-clicking on the entry for a non-active project or a non-active document will bring up an associated menu with commands targeting the focused project or focused document, respectively.
In the case of focusing a document, the document will only become focused if it is closed or hidden, otherwise it will become the active document and its parent project will become the active project. For example, in the image below, the active project is
Blank PCB Project.PrjPcb and the active document is
Sheet1.SchDoc. The focused document is
Sheet2.SchDoc (distinguished in the panel by a dotted outline box) in the inactive
Document entries in the Projects panel are accompanied by icons that indicate their open/modified/version control status. This provides a quick visual summary of which documents are modified, saved or hidden and the their version control status. The document icons and meanings are listed below.
|[blank]||The document is closed.|
|Open – The document is open as a tabbed document in the design editor window.|
|Hidden – The document is hidden (open, but not displayed in the workspace). Use the right-click menu option to hide project files.|
|Open/Modified – The document is open and has been modified (yet to be saved).|
|Modified (applies to projects) – Appears next to the main project document to show that its structure has been modified (yet to be saved).|
|[blank]||The file is not under version control in a VCS repository,|
|No modification||The local copy of the file matches the file in the repository and is up to date.|
|Scheduled for Addition||A file has been added to version control but not yet Committed (checked in) to the VCS repository.|
|Modified||The local copy of the file has been modified in Altium Designer and saved to the working folder. Commit the file to create a new revision in the repository.|
|Out of date||The local copy of the file (in the working folder) is older than its counterpart in the repository and is therefore out of date. Use the Version Control Update option to retrieve the latest file from the repository, or Save the file which will create a Conflict condition.|
|Conflict||The file has been committed by another Altium Designer user before you have committed your own edited and saved version of that file. Use the Version Control Update or Resolve command to determine which version of the file will become the latest revision in the repository.|
|Scheduled for Deletion||The project file has been removed from version control in Altium Designer, and will be deleted from the VCS repository and database during the Version Control Commit process. This icon is also used when a file is missing from the local working folder (it has been deleted, renamed or moved), which is resolved by repopulating the folder from the repository with the Version Control Update command.|
|Locked||The file has been locked by you or by another user. A locked file cannot be updated to a new revision in the repository by another user (unless it is forced to be unlocked). This state can be associated with other icons, such as those for Modified or No Modification, when these status conditions also apply.|
Right-clicking on a Project file in the Projects panel provides access to additional options and commands via the right-click menu.
Right-click selections include:
Right-clicking on a Document file in the Projects panel provides access to a pop-up context menu offering a range of document-specific options and commands.
Several right-click options are basically the same as when right-clicking on a Project, outlined above (for example, Variants). Others include: