Package org.eclipse.ui

Interface IPartListener2

public interface IPartListener2

Interface for listening to part lifecycle events.

This is a replacement for IPartListener.

As of 3.5, if the implementation of this listener also implements IPageChangedListener then it will also be notified about PageChangedEvents from parts that implement IPageChangeProvider.

This interface may be implemented by clients.

See Also:

IPartService.addPartListener(IPartListener2)

Method Summary

Modifier and Type	Method	Description
void	partActivated(IWorkbenchPartReference partRef)	Notifies this listener that the given part has been activated.
void	partBroughtToTop(IWorkbenchPartReference partRef)	Notifies this listener that the given part has been brought to the top.
void	partClosed(IWorkbenchPartReference partRef)	Notifies this listener that the given part has been closed.
void	partDeactivated(IWorkbenchPartReference partRef)	Notifies this listener that the given part has been deactivated.
void	partHidden(IWorkbenchPartReference partRef)	Notifies this listener that the given part is hidden or obscured by another part.
void	partInputChanged(IWorkbenchPartReference partRef)	Notifies this listener that the given part's input was changed.
void	partOpened(IWorkbenchPartReference partRef)	Notifies this listener that the given part has been opened.
void	partVisible(IWorkbenchPartReference partRef)	Notifies this listener that the given part is visible.

Method Detail

partActivated

void partActivated(IWorkbenchPartReference partRef)

Notifies this listener that the given part has been activated.

Parameters:

partRef - the part that was activated

See Also:

IWorkbenchPage.activate(org.eclipse.ui.IWorkbenchPart)

partBroughtToTop

void partBroughtToTop(IWorkbenchPartReference partRef)

Notifies this listener that the given part has been brought to the top.

These events occur when an editor is brought to the top in the editor area, or when a view is brought to the top in a page book with multiple views. They are normally only sent when a part is brought to the top programmatically (via IPerspective.bringToTop). When a part is activated by the user clicking on it, only partActivated is sent.

Parameters:

partRef - the part that was surfaced

See Also:

IWorkbenchPage.bringToTop(org.eclipse.ui.IWorkbenchPart)

partClosed

void partClosed(IWorkbenchPartReference partRef)

Notifies this listener that the given part has been closed.

Note that if other perspectives in the same page share the view, this notification is not sent. It is only sent when the view is being removed from the page entirely (it is being disposed).

Parameters:

partRef - the part that was closed

See Also:

IWorkbenchPage.hideView(org.eclipse.ui.IViewPart)

partDeactivated

void partDeactivated(IWorkbenchPartReference partRef)

Notifies this listener that the given part has been deactivated.

Parameters:

partRef - the part that was deactivated

See Also:

IWorkbenchPage.activate(org.eclipse.ui.IWorkbenchPart)

partOpened

void partOpened(IWorkbenchPartReference partRef)

Notifies this listener that the given part has been opened.

Note that if other perspectives in the same page share the view, this notification is not sent. It is only sent when the view is being newly opened in the page (it is being created).

Parameters:

partRef - the part that was opened

See Also:

IWorkbenchPage.showView(java.lang.String)

partHidden

void partHidden(IWorkbenchPartReference partRef)

Notifies this listener that the given part is hidden or obscured by another part.

Parameters:

partRef - the part that is hidden or obscured by another part

partVisible

void partVisible(IWorkbenchPartReference partRef)

Notifies this listener that the given part is visible.

Parameters:

partRef - the part that is visible

partInputChanged

void partInputChanged(IWorkbenchPartReference partRef)

Notifies this listener that the given part's input was changed.

Parameters:

partRef - the part whose input was changed