| org.eclipse.ui.intro.IIntroPart
All known Subclasses: org.eclipse.ui.part.IntroPart,
| IIntroPart | | public interface IIntroPart extends IAdaptable(Code) | | The intro part is a visual component within the workbench responsible for
introducing the product to new users. The intro part is typically shown the
first time a product is started up.
The intro part implementation is contributed to the workbench via the
org.eclipse.ui.intro extension point. There can be several
intro part implementations, and associations between intro part
implementations and products. The workbench will only make use of the intro
part implementation for the current product (as given by
org.eclipse.core.runtime.Platform.getProduct . There is at most one
intro part instance in the entire workbench, and it resides in exactly one
workbench window at a time.
This interface in not intended to be directly implemented. Rather, clients
providing a intro part implementation should subclass
org.eclipse.ui.part.IntroPart .
See Also: org.eclipse.ui.intro.IIntroManager.showIntro(org.eclipse.ui.IWorkbenchWindowboolean)
since:
3.0 |
| Field Summary | |
| final public static int | PROP_TITLE
The property id for getTitleImage and
getTitle. |
| Method Summary | |
| public void | addPropertyListener(IPropertyListener listener)
Adds a listener for changes to properties of this intro part. | | public void | createPartControl(Composite parent)
Creates the SWT controls for this intro part.
Clients should not call this method (the workbench calls this method when
it needs to, which may be never).
For implementors this is a multi-step process:
- Create one or more controls within the parent.
- Set the parent layout as needed.
- Register any global actions with the
IActionService.
- Register any popup menus with the
IActionService.
- Register a selection provider with the
ISelectionService
(optional). | | public void | dispose()
Disposes of this intro part.
This is the last method called on the IIntroPart. | | IIntroSite | getIntroSite()
Returns the site for this intro part. | | public String | getTitle()
Returns the title of this intro part. | | public Image | getTitleImage()
Returns the title image of this intro part. | | public void | init(IIntroSite site, IMemento memento)
Initializes this intro part with the given intro site. | | public void | removePropertyListener(IPropertyListener listener)
Removes the given property listener from this intro part. | | public void | saveState(IMemento memento)
Saves the object state within a memento.
This method is automatically called by the workbench at appropriate
times. | | public void | setFocus()
Asks this part to take focus within the workbench.
Clients should not call this method (the workbench calls this method at
appropriate times). | | public void | standbyStateChanged(boolean standby)
Sets the standby state of this intro part. |
| PROP_TITLE | | final public static int PROP_TITLE(Code) | | The property id for getTitleImage and
getTitle.
since:
3.2 this property now covers changes to getTitle in
since:
addition to getTitleImage |
| addPropertyListener | | public void addPropertyListener(IPropertyListener listener)(Code) | | Adds a listener for changes to properties of this intro part.
Has no effect if an identical listener is already registered.
The properties ids are as follows:
Parameters:
listener - a property listener |
| createPartControl | | public void createPartControl(Composite parent)(Code) | | Creates the SWT controls for this intro part.
Clients should not call this method (the workbench calls this method when
it needs to, which may be never).
For implementors this is a multi-step process:
- Create one or more controls within the parent.
- Set the parent layout as needed.
- Register any global actions with the
IActionService.
- Register any popup menus with the
IActionService.
- Register a selection provider with the
ISelectionService
(optional).
Parameters:
parent - the parent control |
| dispose | | public void dispose()(Code) | | Disposes of this intro part.
This is the last method called on the IIntroPart. At this
point the part controls (if they were ever created) have been disposed as part
of an SWT composite. There is no guarantee that createPartControl() has been
called, so the part controls may never have been created.
Within this method a part may release any resources, fonts, images, etc.
held by this part. It is also very important to deregister all listeners
from the workbench.
Clients should not call this method (the workbench calls this method at
appropriate times).
|
| getIntroSite | | IIntroSite getIntroSite()(Code) | | Returns the site for this intro part.
the intro site |
| getTitle | | public String getTitle()(Code) | | Returns the title of this intro part. If this value changes
the part must fire a property listener event with
IIntroPart.PROP_TITLE .
The title is used to populate the title bar of this part's visual
container.
the intro part title (not null)
since:
3.2 |
| getTitleImage | | public Image getTitleImage()(Code) | | Returns the title image of this intro part. If this value changes
the part must fire a property listener event with
IIntroPart.PROP_TITLE .
The title image is usually used to populate the title bar of this part's
visual container. Since this image is managed by the part itself, callers
must not dispose the returned image.
the title image |
| init | | public void init(IIntroSite site, IMemento memento) throws PartInitException(Code) | | Initializes this intro part with the given intro site. A memento is
passed to the part which contains a snapshot of the part state from a
previous session. Where possible, the part should try to recreate that
state.
This method is automatically called by the workbench shortly after
part construction. It marks the start of the intro's lifecycle. Clients
must not call this method.
Parameters:
site - the intro site
Parameters:
memento - the intro part state or null if there is no previoussaved state
exception:
PartInitException - if this part was not initializedsuccessfully |
| removePropertyListener | | public void removePropertyListener(IPropertyListener listener)(Code) | | Removes the given property listener from this intro part.
Has no affect if an identical listener is not registered.
Parameters:
listener - a property listener |
| saveState | | public void saveState(IMemento memento)(Code) | | Saves the object state within a memento.
This method is automatically called by the workbench at appropriate
times. Clients must not call this method directly.
Parameters:
memento - a memento to receive the object state |
| setFocus | | public void setFocus()(Code) | | Asks this part to take focus within the workbench.
Clients should not call this method (the workbench calls this method at
appropriate times). To have the workbench activate a part, use
IIntroManager.showIntro(IWorkbenchWindowboolean) .
|
| standbyStateChanged | | public void standbyStateChanged(boolean standby)(Code) | | Sets the standby state of this intro part. An intro part should render
itself differently in the full and standby modes. In standby mode, the
part should be partially visible to the user but otherwise allow them
to work. In full mode, the part should be fully visible and be the center
of the user's attention.
This method is automatically called by the workbench at appropriate
times. Clients must not call this method directly (call
IIntroManager.setIntroStandby(IIntroPartboolean) instead.
Parameters:
standby - true to put this part in its partiallyvisible standy mode, and false to make it fully visible |
|
|