| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| <html lang="en"> |
| <HEAD> |
| |
| <meta name="copyright" |
| content="Copyright (c) IBM Corporation and others 2000, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page."> |
| |
| <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1"> |
| <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> |
| |
| <LINK REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" |
| TYPE="text/css"> |
| <title>Project Explorer view</title> |
| <script language="JavaScript" |
| src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"> </script> |
| </HEAD> |
| |
| <BODY BGCOLOR="#ffffff"> |
| <h1>Project Explorer view</H1> |
| <P CLASS="Intro">This view provides a hierarchical view of the |
| artifacts in the Workbench, which is customized by the specific |
| configuration of your Workbench.</p> |
| <P>From here, you can open files for editing or select resources for operations such as exporting.</P> |
| <P CLASS="Para">A typical Project Explorer with only the Java |
| Development Tools (JDT) installed looks similar to the Package Explorer:</P> |
| <P CLASS="Para"><img src="../images/Image275_project_explorer.png" |
| alt="Project Explorer View" border="0"></P> |
| <P>Right-click on any resource in the Project Explorer view to open a pop-up menu that allows you to perform operations such as copying, moving, creating new resources, comparing resources with each other, or performing team operations. To see a description of what each menu item does, move selection highlight to that menu item and press the context-sensitive help key (e.g., F1 on Microsoft Windows).</P> |
| <p CLASS="Head">By default, the Project Explorer view is included in the Resources perspective. To add the Project Explorer view to the current |
| perspective, click <a class="command-link" |
| href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.ui.navigator.ProjectExplorer)")'> |
| <img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="command link"> <b>Window |
| > Show View > Other... > General > Project Explorer</b></a>.</p> |
| <P CLASS="Para"> </P> |
| <h2>Toolbar</h2> |
| <DIV CLASS="Topic"></DIV> |
| <H3>Collapse All</H3> |
| <P>This command collapses the tree expansion state of all resources |
| in the view.</P> |
| <H3>Link with Editor</H3> |
| <P>This command toggles whether the Project Explorer selection is |
| linked to the active editor. When this option is selected, changing the |
| active editor will automatically update the Project Explorer selection to the |
| resource being edited.</P> |
| <H3>Select and deselect content to filter to the content in the tree</H3> |
| <P>This command opens a dialog allowing to configure some filters to enable.</P> |
| <P><BR> |
| </P> |
| <H2>View Menus</H2> |
| <P>Click the ⋮ vertical ellipsis to open a menu of items |
| specific to the Project Explorer. Some extra menu entries can be |
| added by extension and may not be documented here.</P> |
| <H3>Project Presentation</H3> |
| <P>Select whether the physically nested projects should be shown as root elements (Flat), or |
| should be shown under their parent project in place of their corresponding folder (Hierarchical). |
| <H3>Top-Level Elements</H3> |
| <P>Select whether the top level-elements should be the selected working sets with projects as children, |
| or the visible projects.</P> |
| <H3>Select Working Set</H3> |
| <P>Opens the <B>Select Working Set</B> dialog to allow selecting a |
| working set for the Project Explorer.</P> |
| <H3>Deselect Working Set</H3> |
| <P>Deselects the current working set.</P> |
| <H3>Edit Active Working Set</H3> |
| <P>Opens the <B>Edit Working Set</B> dialog to allow changing the |
| current working set.</P> |
| <P><BR> |
| In addition to these menu items, the Project Explorer menu shows a list of |
| recently used working sets that have been selected in the view.</P> |
| <DIV CLASS="Topic"> |
| <h3>Filters and Customization</h3> |
| <P CLASS="Para">This command allows you to change the view for your |
| specific needs. You may select pre-defined filters to apply to the view so that you |
| can show or hide various artifacts as needed. The default filters |
| available with the Java development tools (JDT) is shown below:</P> |
| <P CLASS="Para"><img src="../images/Image276_available_filters.png" |
| alt="Available Customizations > Filters dialog" border="0"></P> |
| |
| <P class="Para">You can also define your own filters based on the name |
| of a resource. Full name or regular expressions are allowed.</P> |
| <P CLASS="Para"><img src="../images/Image276_user_filters.png" |
| alt="Available Customizations > User filters dialog" border="0"></P> |
| </P> |
| |
| <P CLASS="Para">You may also choose the types of content for the view |
| to show as well. The default content extensions available with the |
| Java development tools (JDT) is shown below, but your specific extensions |
| will be determined by your workbench configuration:</P> |
| <P CLASS="Para"><img src="../images/Image276_available_content.png" |
| alt="Available Customizations > Content dialog" border="0"></P> |
| </DIV> |
| <H3>Link with Editor</H3> |
| <P>See the toolbar item description above.</P> |
| <P><BR> |
| </P> |
| |
| <h2>Context menu</h2> |
| <P>The context-menu allows to access some general Project management operations as |
| well as operations that are specific to your selection. Some plugins can extend the |
| context-menu with additional entries that might not be documented here.</P> |
| <DIV CLASS="Topic"> |
| <h3 CLASS="Head">New</H3> |
| <P CLASS="Para">This command allows you to create a new resource in |
| the Workbench. Select the type of resource to create from the submenu.</P> |
| </DIV> |
| <DIV CLASS="Topic"> |
| <h3 CLASS="Head">Copy</H3> |
| <P CLASS="Para">This command copies the selected resource to the |
| clipboard.</P> |
| </DIV> |
| <H3>Paste</H3> |
| <P>This command pastes resources on the clipboard into the selected |
| project or folder. If a resource is selected the resources on the |
| clipboard are pasted as siblings of the selected resource.</P> |
| <h3 CLASS="Head">Delete</H3> |
| <P CLASS="Para">This command deletes the selected resource from the |
| workspace.</P> |
| <DIV CLASS="Topic"> |
| <h3 CLASS="Head">Move</H3> |
| <P CLASS="Para">This command moves the selected resource to another |
| location. A dialog will appear, prompting for the destination location |
| to which the resource will be moved. </P> |
| </DIV> |
| <DIV CLASS="Topic"> |
| <h3 CLASS="Head">Rename</H3> |
| <P CLASS="Para">This command allows you to specify a new name for |
| the selected resource.</P> |
| </DIV> |
| <DIV CLASS="Topic"> |
| <h3 CLASS="Head">Import</H3> |
| <P CLASS="Para">This command opens the import wizard and allows you |
| to select resources to import into the Workbench.</P> |
| </DIV> |
| |
| <DIV CLASS="Topic"> |
| <h3 CLASS="Head">Export</H3> |
| <P CLASS="Para">This command opens the export wizard and allows you |
| to export resources to an external location.</P> |
| </DIV> |
| |
| <h3 CLASS="Head">Refresh</H3> |
| <P CLASS="Para">This command refreshes the Workbench's view of the |
| selected resource and its children. For example, this is used when you |
| create a new file for an existing project outside the Workbench and want |
| the file to appear in the Project Explorer view.</P> |
| <DIV CLASS="Topic"> |
| <h3 CLASS="Head">Close Project</H3> |
| <P CLASS="Para">The close project command is visible when an open |
| project is selected. This command closes the selected project.</P> |
| </DIV> |
| <DIV CLASS="Topic"> |
| <h3 CLASS="Head">Close Unrelated Projects</H3> |
| <P CLASS="Para">This command will close any project which are |
| unrelated to the selected project.</P> |
| </DIV> |
| <H3>Open Project</H3> |
| <P>The open project command is visible when a closed project is |
| selected. This command opens the selected project.</P> |
| <DIV CLASS="Topic"> |
| <h3 CLASS="Head">Team</H3> |
| <p CLASS="Head">Menu items in the Team sub-menu are related to |
| version control management and are determined by the version control |
| management system that is associated with the project. Eclipse provides |
| the special menu item<b> Share Project...</b> for projects that are not |
| under version control management. This command will present a wizard |
| that allows you to choose to share the project with any version control |
| management systems that has been added to Eclipse. Eclipse ships with |
| support for CVS.</p> |
| </DIV> |
| <DIV CLASS="Topic"> |
| <h3 CLASS="Head">Compare With</H3> |
| |
| <P CLASS="Para">Commands on the Compare With sub-menu allow you to |
| do one of the following types of compares:</P> |
| <UL CLASS="UnorderedList"> |
| <LI CLASS="Item">Compare two or three selected resources with each |
| other</LI> |
| <LI CLASS="Item">Compare the selected resource with remote |
| versions (if the project is associated with a version control |
| management system).</LI> |
| <LI CLASS="Item">Compare the selected resource with a local |
| history state</LI> |
| </UL> |
| |
| <P CLASS="Para">After you select the type of compare you want to do, |
| you will either see a compare editor or a compare dialog. In the compare |
| editor, you can browse and copy various changes between the compared |
| resources. In the compare dialog, you can only browse through the |
| changes. </P> |
| |
| </DIV> |
| <DIV CLASS="Topic"> |
| <h3 CLASS="Head">Replace With</h3> |
| <P CLASS="Para">Commands on the Replace With sub-menu allow you to |
| replace the selected resource with another state from the local history. |
| If the project is under version control management, there may be |
| additional items supplied by the version control management system as |
| well.</P> |
| </DIV> |
| <DIV CLASS="Topic"> |
| <h3 CLASS="Head">Properties</H3> |
| <P CLASS="Para">This command displays the properties of the selected |
| resource. The kinds of properties that are displayed depend on what type |
| of resource is selected. Resource properties may include (but are not |
| limited to):</P> |
| <UL CLASS="UnorderedList"> |
| <LI CLASS="Item">Path relative to the project in which it is held</LI> |
| <LI CLASS="Item">Type of resource</LI> |
| <LI CLASS="Item">Absolute file system path, or name of path |
| variable when using linked resources</LI> |
| <LI CLASS="Item">Resolved path variable when using a path variable |
| for a linked resource</LI> |
| <LI CLASS="Item">Size of resource</LI> |
| <LI CLASS="Item">Last modified date</LI> |
| <LI CLASS="Item">Read-only status</LI> |
| <LI CLASS="Item">Derived resource status</LI> |
| <LI CLASS="Item">Execution arguments, if it is an executable |
| resource</LI> |
| <LI CLASS="Item">Program launchers, if it is launchable</LI> |
| <LI CLASS="Item">Project dependencies, if any</LI> |
| </UL> |
| </DIV> |
| |
| <h3 class="related">Related concepts</h3> |
| <a href="../concepts/cworkset.htm">Working Sets</a> <br> |
| <a href="../concepts/concepts-26.htm">Team programming with CVS</a> <br> |
| <a HREF="../concepts/concepts-29.htm">Three-way compare</a> <br> |
| <a href="../concepts/concepts-13.htm">Linked resources</a> |
| |
| <p><h3 class="related">Related reference</h3> |
| <a href="ref-25.htm">Compare editor</a> |
| |
| </BODY> |
| </HTML> |