org.eclipse.ui.actions
Class PartEventAction

java.lang.Object
  |
  +--org.eclipse.jface.action.Action
        |
        +--org.eclipse.ui.actions.PartEventAction

All Implemented Interfaces:

IAction, IPartListener

Direct Known Subclasses:

RetargetAction

public abstract class PartEventAction

extends Action

implements IPartListener

The abstract superclass for actions that listen to part activation and open/close events. This implementation tracks the active part (see getActivePart) and provides a convenient place to monitor part lifecycle events that could affect the availability of the action.

Subclasses must implement the following IAction method:

• run - to do the action's work

Subclasses may extend any of the IPartListener methods if the action availablity needs to be recalculated:

• partActivated
• partDeactivated
• partOpened
• partClosed
• partBroughtToTop

Field Summary

Fields inherited from interface org.eclipse.jface.action.IAction

AS_CHECK_BOX, AS_DROP_DOWN_MENU, AS_PUSH_BUTTON, CHECKED, DESCRIPTION, ENABLED, IMAGE, TEXT, TOOL_TIP_TEXT

Constructor Summary

protected

PartEventAction(String text) Creates a new action with the given text.

Method Summary

IWorkbenchPart	getActivePart() Returns the currently active part in the workbench.
void	partActivated(IWorkbenchPart part) The PartEventAction implementation of this IPartListener method records that the given part is active.
void	partBroughtToTop(IWorkbenchPart part) The PartEventAction implementation of this IPartListener method does nothing.
void	partClosed(IWorkbenchPart part) The PartEventAction implementation of this IPartListener method clears the active part if it just closed.
void	partDeactivated(IWorkbenchPart part) The PartEventAction implementation of this IPartListener method records that there is no active part.
void	partOpened(IWorkbenchPart part) The PartEventAction implementation of this IPartListener method does nothing.

Methods inherited from class org.eclipse.jface.action.Action

addPropertyChangeListener, convertAccelerator, convertAccelerator, findKeyCode, findKeyString, findModifier, findModifierString, firePropertyChange, firePropertyChange, getAccelerator, getActionDefinitionId, getDescription, getDisabledImageDescriptor, getHelpListener, getHoverImageDescriptor, getId, getImageDescriptor, getMenuCreator, getStyle, getText, getToolTipText, isChecked, isEnabled, removeAcceleratorText, removePropertyChangeListener, run, runWithEvent, setAccelerator, setActionDefinitionId, setChecked, setDescription, setDisabledImageDescriptor, setEnabled, setHelpListener, setHoverImageDescriptor, setId, setImageDescriptor, setMenuCreator, setText, setToolTipText

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PartEventAction

protected PartEventAction(String text)

Creates a new action with the given text.

Parameters:

text - the string used as the text for the action, or null if these is no text

Method Detail

getActivePart

public IWorkbenchPart getActivePart()

Returns the currently active part in the workbench.

Returns:

currently active part in the workbench, or null if none

partActivated

public void partActivated(IWorkbenchPart part)

The PartEventAction implementation of this IPartListener method records that the given part is active. Subclasses may extend this method if action availability has to be recalculated.

Specified by:

partActivated in interface IPartListener

Parameters:

part - the part that was activated

See Also:

IPerspective#activate

partBroughtToTop

public void partBroughtToTop(IWorkbenchPart part)

The PartEventAction implementation of this IPartListener method does nothing. Subclasses should extend this method if action availability has to be recalculated.

Specified by:

partBroughtToTop in interface IPartListener

Parameters:

part - the part that was surfaced

See Also:

IPerspective#bringToTop

partClosed

public void partClosed(IWorkbenchPart part)

The PartEventAction implementation of this IPartListener method clears the active part if it just closed. Subclasses may extend this method if action availability has to be recalculated.

Specified by:

partClosed in interface IPartListener

Parameters:

part - the part that was closed

See Also:

IPerspective#close

partDeactivated

public void partDeactivated(IWorkbenchPart part)

The PartEventAction implementation of this IPartListener method records that there is no active part. Subclasses may extend this method if action availability has to be recalculated.

Specified by:

partDeactivated in interface IPartListener

Parameters:

part - the part that was deactivated

See Also:

IPerspective#activate

partOpened

public void partOpened(IWorkbenchPart part)

The PartEventAction implementation of this IPartListener method does nothing. Subclasses should extend this method if action availability has to be recalculated.

Specified by:

partOpened in interface IPartListener

Parameters:

part - the part that was opened