|
Eclipse Platform 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.eclipse.jface.action.Action | +--org.eclipse.ui.actions.SelectionListenerAction | +--org.eclipse.ui.actions.WorkspaceAction
The abstract superclass for actions whose only role in life is to invoke core commands on a set of selected resources. When the action is run, all the work is done within a modal progress dialog. It iterates over all selected resources; errors are collected and displayed to the user via a problems dialog at the end of the operation. User requests to cancel the operation are passed along to the core.
Subclasses must implement the following methods:
invokeOperation
- to perform the operation on one of the
selected resourcesgetOperationMessage
- to furnish a title for the progress
dialogSubclasses may override the following methods:
shouldPerformResourcePruning
- reimplement to turn offupdateSelection
- extend to refine enablement criteriagetProblemsTitle
- reimplement to furnish a title for the
problems dialoggetProblemsMessage
- reimplement to furnish a message for
the problems dialogrun
- extend to
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 |
WorkspaceAction(Shell shell,
String text)
Creates a new action with the given text. |
Method Summary | |
protected List |
getActionResources()
Returns the elements that the action is to be performed on. |
void |
run()
The CoreWrapperAction implementation of this IAction
method uses a ProgressMonitorDialog to run the operation. |
protected boolean |
updateSelection(IStructuredSelection selection)
The WorkspaceAction implementation of this
SelectionListenerAction method ensures that this action is
disabled if any of the selected resources are inaccessible. |
Methods inherited from class org.eclipse.ui.actions.SelectionListenerAction |
getSelectedNonResources, getSelectedResources, getStructuredSelection, resourceIsType, selectionChanged, selectionChanged, selectionIsOfType |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
protected WorkspaceAction(Shell shell, String text)
shell
- the shell (for the modal progress dialog and error messages)text
- the string used as the text for the action,
or null
if these is no textMethod Detail |
public void run()
CoreWrapperAction
implementation of this IAction
method uses a ProgressMonitorDialog
to run the operation. The
operation calls execute
(which, in turn, calls
invokeOperation
). Afterwards, any CoreException
s
encountered while running the operation are reported to the user via a
problems dialog.
Subclasses may extend this method.
run
in interface IAction
run
in class Action
protected boolean updateSelection(IStructuredSelection selection)
WorkspaceAction
implementation of this
SelectionListenerAction
method ensures that this action is
disabled if any of the selected resources are inaccessible. Subclasses may
extend to react to selection changes; however, if the super method returns
false
, the overriding method should also return false
.
updateSelection
in class SelectionListenerAction
selection
- the new selection
true
if the action should be enabled for this selection,
and false
otherwiseprotected List getActionResources()
IResource
)
|
Eclipse Platform 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |