public class PropertySheet extends PageBookView implements ISelectionListener
This standard view has id "org.eclipse.ui.views.PropertySheet".
Note that property IPropertySheetPages.
Property sheet pages are discovered by the property sheet view automatically
when a part is first activated. The property sheet view asks the active part
for its property sheet page; this is done by invoking
getAdapter(IPropertySheetPage.class) on the part. If the part
returns a page, the property sheet view then creates the controls for that
property sheet page (using createControl), and adds the page to
the property sheet view. Whenever this part becomes active, its corresponding
property sheet page is shown in the property sheet view (which may or may not
be visible at the time). A part's property sheet page is discarded when the
part closes. The property sheet view has a default page (an instance of
PropertySheetPage) which services all parts without a property
sheet page of their own.
The workbench will automatically instantiates this class when a Property Sheet view is needed for a workbench window. This class is not intended to be instantiated or subclassed by clients.
IPropertySheetPage,
PropertySheetPagePageBookView.PageRec, PageBookView.SelectionProvider| Modifier and Type | Field and Description |
|---|---|
static String |
HELP_CONTEXT_PROPERTY_SHEET_VIEW
No longer used but preserved to avoid api change
|
PROP_TITLE| Constructor and Description |
|---|
PropertySheet()
Creates a property sheet view.
|
| Modifier and Type | Method and Description |
|---|---|
protected IPage |
createDefaultPage(PageBook book)
Creates and returns the default page for this view.
|
void |
createPartControl(Composite parent)
The
PropertySheet implementation of this IWorkbenchPart
method creates a PageBook control with its default page showing. |
void |
dispose()
The
PageBookView implementation of this
IWorkbenchPart method cleans up all the pages. |
protected PageBookView.PageRec |
doCreatePage(IWorkbenchPart part)
Creates a new page in the pagebook for a particular part.
|
protected void |
doDestroyPage(IWorkbenchPart part,
PageBookView.PageRec rec)
Destroys a page in the pagebook for a particular part.
|
protected IWorkbenchPart |
getBootstrapPart()
Returns the active, important workbench part for this view.
|
protected ISaveablePart |
getSaveablePart()
Returns an
ISaveablePart that delegates to the source part
for the current page if it implements ISaveablePart, or
null otherwise. |
protected Object |
getViewAdapter(Class key)
The
PropertySheet implementation of this
PageBookView method handles the ISaveablePart
adapter case by calling getSaveablePart(). |
void |
init(IViewSite site)
Initializes this view with the given view site.
|
protected boolean |
isImportant(IWorkbenchPart part)
Returns whether the given part should be added to this view.
|
void |
partActivated(IWorkbenchPart part)
The
PropertySheet implementation of this IPartListener
method first sees if the active part is an IContributedContentsView
adapter and if so, asks it for its contributing part. |
void |
selectionChanged(IWorkbenchPart part,
ISelection sel)
Notifies this listener that the selection has changed.
|
doesPageExist, getAdapter, getCurrentContributingPart, getCurrentPage, getDefaultPage, getPageBook, getPageRec, getPageRec, getPageSite, getSelectionProvider, initPage, partBroughtToTop, partClosed, partDeactivated, partOpened, setFocus, showPageReccheckSite, getViewSite, init, saveState, setContentDescription, setInitializationData, setPartNameaddPropertyListener, firePropertyChange, getConfigurationElement, getContentDescription, getDefaultImage, getOrientation, getPartName, getSite, getTitle, getTitleImage, getTitleToolTip, removePropertyListener, setSite, setTitle, setTitleImage, setTitleToolTip, showBusyaddListenerObject, clearListeners, getListeners, isListenerAttached, removeListenerObjectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitaddPropertyListener, getSite, getTitle, getTitleImage, getTitleToolTip, removePropertyListenerpublic static final String HELP_CONTEXT_PROPERTY_SHEET_VIEW
protected IPage createDefaultPage(PageBook book)
PageBookViewSubclasses must implement this method.
Subclasses must call initPage with the new page (if it is an
IPageBookViewPage) before calling createControl on the
page.
createDefaultPage in class PageBookViewbook - the pagebook controlpublic void createPartControl(Composite parent)
PropertySheet implementation of this IWorkbenchPart
method creates a PageBook control with its default page showing.createPartControl in interface IWorkbenchPartcreatePartControl in class PageBookViewparent - the parent controlpublic void dispose()
PageBookViewPageBookView implementation of this
IWorkbenchPart method cleans up all the pages. Subclasses
may extend.dispose in interface IWorkbenchPartdispose in class PageBookViewprotected PageBookView.PageRec doCreatePage(IWorkbenchPart part)
PageBookViewdoDestroyPage.
Subclasses must implement this method.
Subclasses must call initPage with the new page (if it is an
IPageBookViewPage) before calling createControl on the
page.
doCreatePage in class PageBookViewpart - the input partPageBookView.doDestroyPage(org.eclipse.ui.IWorkbenchPart, org.eclipse.ui.part.PageBookView.PageRec)protected void doDestroyPage(IWorkbenchPart part, PageBookView.PageRec rec)
PageBookViewdoCreatePage.
Subclasses must implement this method.
doDestroyPage in class PageBookViewpart - the input partrec - a page record for the partPageBookView.doCreatePage(org.eclipse.ui.IWorkbenchPart)protected IWorkbenchPart getBootstrapPart()
PageBookView
When the page book view is created it has no idea which part within the
workbook should be used to generate the first page. Therefore, it
delegates the choice to subclasses of PageBookView.
Implementors of this method should return an active, important part in
the workbench or null if none found.
Subclasses must implement this method.
getBootstrapPart in class PageBookViewnull if nonepublic void init(IViewSite site) throws PartInitException
IViewPartThis method is automatically called by the workbench shortly after the part is instantiated. It marks the start of the views's lifecycle. Clients must not call this method.
init in interface IViewPartinit in class PageBookViewsite - the view sitePartInitException - if this view was not initialized successfullyprotected boolean isImportant(IWorkbenchPart part)
PageBookViewSubclasses must implement this method.
isImportant in class PageBookViewpart - the input parttrue if the part is relevant, and
false otherwisepublic void partActivated(IWorkbenchPart part)
PropertySheet implementation of this IPartListener
method first sees if the active part is an IContributedContentsView
adapter and if so, asks it for its contributing part.partActivated in interface IPartListenerpartActivated in class PageBookViewpart - the part that was activatedIWorkbenchPage.activate(org.eclipse.ui.IWorkbenchPart)public void selectionChanged(IWorkbenchPart part, ISelection sel)
ISelectionListener
This method is called when the selection changes from one to a
non-null value, but not when the selection changes to
null. If there is a requirement to be notified in the latter
scenario, implement INullSelectionListener. The event will
be posted through this method.
selectionChanged in interface ISelectionListenerpart - the workbench part containing the selectionsel - the current selection. This may be null
if INullSelectionListener is implemented.protected Object getViewAdapter(Class key)
PropertySheet implementation of this
PageBookView method handles the ISaveablePart
adapter case by calling getSaveablePart().getViewAdapter in class PageBookViewkey - the adapter class to look upnull if
this object does not have an adapter for the given classprotected ISaveablePart getSaveablePart()
ISaveablePart that delegates to the source part
for the current page if it implements ISaveablePart, or
null otherwise.ISaveablePart or nullGuidelines for using Eclipse APIs. Copyright (c) IBM Corp. and others 2000, 2006. All rights reserved.