public class RetargetAction extends PartEventAction implements ActionFactory.IWorkbenchAction
RetargetAction
tracks the active part in the workbench.
Each RetargetAction has an ID. If the active part provides an action
handler for the ID the enable and check state of the RetargetAction
is determined from the enable and check state of the handler. If the
active part does not provide an action handler then this action is
disabled.
Note: instances of this class add themselves as listeners to their action handler. It is important for the creator of a retarget action to call dispose when the action is no longer needed. This will ensure that the listener is removed.
This class may be instantiated. It is not intented to be subclassed.
AS_CHECK_BOX, AS_DROP_DOWN_MENU, AS_PUSH_BUTTON, AS_RADIO_BUTTON, AS_UNSPECIFIED, CHECKED, DESCRIPTION, ENABLED, HANDLED, IMAGE, RESULT, TEXT, TOOL_TIP_TEXT
Constructor and Description |
---|
RetargetAction(String actionID,
String text)
Constructs a RetargetAction with the given action id and text.
|
RetargetAction(String actionID,
String text,
int style)
Constructs a RetargetAction with the given action id, text and style.
|
Modifier and Type | Method and Description |
---|---|
void |
dispose()
Disposes of the action and any resources held.
|
void |
enableAccelerator(boolean b)
Enables the accelerator for this action.
|
int |
getAccelerator()
Returns the accelerator keycode for this action.
|
IAction |
getActionHandler()
Returns the action handler.
|
boolean |
isHandled()
Returns whether this action is handled.
|
void |
partActivated(IWorkbenchPart part)
A workbench part has been activated.
|
void |
partClosed(IWorkbenchPart part)
A workbench part has been closed.
|
void |
partDeactivated(IWorkbenchPart part)
A workbench part has been deactivated.
|
protected void |
propagateChange(PropertyChangeEvent event)
Either the action handler itself has changed, or the configured action
handlers on the action bars have changed.
|
void |
run()
Invoked when an action occurs.
|
void |
runWithEvent(Event event)
Invoked when an action occurs.
|
protected void |
setActionHandler(IAction newHandler)
Sets the action handler.
|
void |
setChecked(boolean checked)
Sets the checked status of this action.
|
void |
setHelpListener(HelpListener listener)
The
RetargetAction implementation of this method declared on
IAction stores the help listener in a local field. |
String |
toString()
Returns a string representation of this action.
|
getActivePart, partBroughtToTop, partOpened
convertAccelerator, convertAccelerator, findKeyCode, findKeyString, findModifier, findModifierString, getActionDefinitionId, getDescription, getDisabledImageDescriptor, getHelpListener, getHoverImageDescriptor, getId, getImageDescriptor, getMenuCreator, getStyle, getText, getToolTipText, isChecked, isEnabled, notifyResult, removeAcceleratorText, removeMnemonics, setAccelerator, setActionDefinitionId, setDescription, setDisabledImageDescriptor, setEnabled, setHoverImageDescriptor, setId, setImageDescriptor, setMenuCreator, setText, setToolTipText
addPropertyChangeListener, firePropertyChange, firePropertyChange, removePropertyChangeListener
addListenerObject, clearListeners, getListeners, isListenerAttached, removeListenerObject
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
addPropertyChangeListener, getActionDefinitionId, getDescription, getDisabledImageDescriptor, getHelpListener, getHoverImageDescriptor, getId, getImageDescriptor, getMenuCreator, getStyle, getText, getToolTipText, isChecked, isEnabled, removePropertyChangeListener, setAccelerator, setActionDefinitionId, setDescription, setDisabledImageDescriptor, setEnabled, setHoverImageDescriptor, setId, setImageDescriptor, setMenuCreator, setText, setToolTipText
public RetargetAction(String actionID, String text)
actionID
- the retargetable action idtext
- the action's text, or null
if there is no textpublic RetargetAction(String actionID, String text, int style)
actionID
- the retargetable action idtext
- the action's text, or null
if there is no textstyle
- one of AS_PUSH_BUTTON
, AS_CHECK_BOX
,
AS_DROP_DOWN_MENU
, AS_RADIO_BUTTON
, and
AS_UNSPECIFIED
public void dispose()
dispose
in interface ActionFactory.IWorkbenchAction
public void enableAccelerator(boolean b)
b
- the new enable statepublic int getAccelerator()
IAction
MenuItem.getAccelerator
.getAccelerator
in interface IAction
getAccelerator
in class Action
MenuItem.getAccelerator()
public void partActivated(IWorkbenchPart part)
partActivated
in interface IPartListener
partActivated
in class PartEventAction
part
- the workbench part that has been activatedIWorkbenchPage.activate(org.eclipse.ui.IWorkbenchPart)
public void partClosed(IWorkbenchPart part)
partClosed
in interface IPartListener
partClosed
in class PartEventAction
part
- the workbench part that has been closedIWorkbenchPage.hideView(IViewPart)
public void partDeactivated(IWorkbenchPart part)
partDeactivated
in interface IPartListener
partDeactivated
in class PartEventAction
part
- the workbench part that has been deactivatedIWorkbenchPage.activate(IWorkbenchPart)
protected void propagateChange(PropertyChangeEvent event)
public void run()
run
in interface IAction
run
in class Action
How radio buttons are handled
,
How check boxes are handled
public void runWithEvent(Event event)
runWithEvent
in interface IAction
runWithEvent
in class Action
event
- the SWT event which triggered this action being runHow radio buttons are handled
,
How check boxes are handled
public IAction getActionHandler()
null
if there is no current
handler.public final boolean isHandled()
IAction
true
. However, if the action delegates some of its
behaviour to some other object, then this method should answer whether
such an object is currently available.protected void setActionHandler(IAction newHandler)
public void setChecked(boolean checked)
IAction
AS_CHECK_BOX
or AS_RADIO_BUTTON
.
Fires a property change event for the CHECKED
property
if the checked status actually changes as a consequence.
setChecked
in interface IAction
setChecked
in class Action
checked
- the new checked statusIAction.CHECKED
public void setHelpListener(HelpListener listener)
RetargetAction
implementation of this method declared on
IAction
stores the help listener in a local field. The
supplied listener is only used if there is no hanlder.setHelpListener
in interface IAction
setHelpListener
in class Action
listener
- a help listener for this action
Copyright (c) 2000, 2015 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.