Eclipse Platform
Release 3.3

org.eclipse.ui
Interface IWorkbenchPart3

All Superinterfaces:
IAdaptable, IWorkbenchPart, IWorkbenchPart2
All Known Implementing Classes:
WorkbenchPart

public interface IWorkbenchPart3
extends IWorkbenchPart2

A part can provide arbitrary properties. The properties will be persisted between sessions by the part reference, and will be available from the part reference as well as the part. The properties can only be set on a part, not on the reference. The properties will be available to the IPresentablePart.

Setting a property must fire a PropertyChangeEvent.

Since:
3.3

Field Summary
 
Fields inherited from interface org.eclipse.ui.IWorkbenchPart
PROP_TITLE
 
Method Summary
 void addPartPropertyListener(IPropertyChangeListener listener)
          Add a listener for changes in the arbitrary properties set.
 Map getPartProperties()
          Return an unmodifiable map of the arbitrary properties.
 String getPartProperty(String key)
          Return the value for the arbitrary property key, or null.
 void removePartPropertyListener(IPropertyChangeListener listener)
          Remove a change listener from the arbitrary properties set.
 void setPartProperty(String key, String value)
          Set an arbitrary property on the part.
 
Methods inherited from interface org.eclipse.ui.IWorkbenchPart2
getContentDescription, getPartName
 
Methods inherited from interface org.eclipse.ui.IWorkbenchPart
addPropertyListener, createPartControl, dispose, getSite, getTitle, getTitleImage, getTitleToolTip, removePropertyListener, setFocus
 
Methods inherited from interface org.eclipse.core.runtime.IAdaptable
getAdapter
 

Method Detail

addPartPropertyListener

public void addPartPropertyListener(IPropertyChangeListener listener)
Add a listener for changes in the arbitrary properties set.

Note: this is a different set of properties than the ones covered by the IWorkbenchPartConstants.PROP_* constants.

Parameters:
listener - Must not be null.

removePartPropertyListener

public void removePartPropertyListener(IPropertyChangeListener listener)
Remove a change listener from the arbitrary properties set.

Note: this is a different set of properties than the ones covered by the IWorkbenchPartConstants.PROP_* constants.

Parameters:
listener - Must not be null.

getPartProperty

public String getPartProperty(String key)
Return the value for the arbitrary property key, or null.

Parameters:
key - the arbitrary property. Must not be null.
Returns:
the property value, or null.

setPartProperty

public void setPartProperty(String key,
                            String value)
Set an arbitrary property on the part. It is the implementor's responsibility to fire the corresponding PropertyChangeEvent.

A default implementation has been added to WorkbenchPart.

Parameters:
key - the arbitrary property. Must not be null.
value - the property value. A null value will remove that property.

getPartProperties

public Map getPartProperties()
Return an unmodifiable map of the arbitrary properties. This method can be used to save the properties during workbench save/restore.

Returns:
A Map of the properties. Must not be null.

Eclipse Platform
Release 3.3

Guidelines for using Eclipse APIs.

Copyright (c) IBM Corp. and others 2000, 2007. All rights reserved.