View source for FAQ Pages, parts, sites, windows: What is all this stuff?

Denizens of the Eclipse newsgroups, clearly
expressing frustration with the overwhelming sea of terms, have been known to
ask, &#147;What is the Eclipsian word for X?,&#148; or &#147;What is that thingy
called in Eclipse Speak?.&#148; In an effort to assuage the suffering of new users, 
the following is a mile-high view of the pieces of the Eclipse UI.

The term used to represent the entire UI is <i>workbench</i>.  The workbench
itself has no physical manifestation, but the workbench object is used to
access most of the general APIs and services available in the generic UI.
The workbench is displayed in one or more <i>workbench windows</i>. 
These basic top-level windows make up an Eclipse application.  
Note that dialogs, wizards, and other transient pop-ups are 
not called workbench windows.  

At the top of each window is the <i>title bar</i>, typically
a native widget with a title and controls for resizing and closing. Next comes the
<i>menu bar</i>, and after that is the <i>cool bar</i>. The cool bar is a fancy 
term for a bar of buttons that can be dragged around and reorganized across multiple
lines. On the left, right, or bottom, depending on user preference, is the
<i>fast view bar</i>, where <i>fast views</i>&#151;iconified views&#151;are stored. At the
bottom is the <i>status line</i>, where various bits of information 
are shown; the far-right corner of the status line is called 
the <i>progress indicator</i>.

The main body of a workbench window is represented by the 
<i>workbench page</i>, which in turn is made up of <i>workbench 
parts</i>, which come in two varieties: <i>views</i> and <i>editors</i>.  The initial size
and orientation of the parts in the page are determined by a <i>perspective</i>.

Parts interact with the rest of the window via their <i>site</i>.  
The site is not a visible entity but simply an API mechanism to separate the methods 
that operate on the view from the methods that operate 
on controls and services outside the view.  This allows the workbench
implementers to add new features to the sites without breaking all the plug-ins 
that implement the parts. Figure 9.1 Spider graph shows how a view (<tt>ContentOutline</tt>)
and an editor (<tt>WelcomeEditor</tt>) each has its own site, which is hosted by a
page, inside a workbench window, owned by the workbench.

[[Image:FAQ_views.png]]
'''Figure 9.1'''&nbsp;&nbsp;Spider diagram of site parts

In addition, sites bring together that functionality 
that different parts of the workbench had in common but could not be 
expressed well in a single inheritance hierarchy.

== See Also: ==
*[[FAQ_What_is_the_difference_between_a_perspective_and_a_workbench_page%3F]]
*[[FAQ_What_is_a_view%3F]]
*[[FAQ_What_is_the_difference_between_a_view_and_an_editor%3F]]

{{Template:FAQ_Tagline}}