public abstract class SelectionDispatchAction
extends Action
IAction#run()
and the
ISelectionChangedListener#selectionChanged
according to the type of the selection.
ITextSelection
then
run(ITextSelection)
and selectionChanged(ITextSelection)
is called.IStructuredSelection
then
run(IStructuredSelection)
and
selectionChanged(IStructuredSelection)
is called.run(ISelection)
and
selectionChanged(ISelection)
.Note: This class is not intended to be subclassed outside the JDT UI plug-in.
Provisional API: This class/interface is part of an interim API that is still under development and expected to change significantly before reaching stability. It is being made available at this early stage to solicit feedback from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken (repeatedly) as the API evolves.Modifier | Constructor and Description |
---|---|
protected |
SelectionDispatchAction(IWorkbenchSite site)
Creates a new action with no text and no image.
|
Modifier and Type | Method and Description |
---|---|
ISelection |
getSelection()
Returns the selection provided by the site owning this action.
|
ISelectionProvider |
getSelectionProvider()
Returns the selection provider managed by the site owning this action or the selection
provider explicitly set in
setSpecialSelectionProvider(ISelectionProvider) . |
Shell |
getShell()
Returns the shell provided by the site owning this action.
|
IWorkbenchSite |
getSite()
Returns the site owning this action.
|
void |
run() |
void |
run(ISelection selection)
Executes this actions with the given selection.
|
void |
run(IStructuredSelection selection)
Executes this actions with the given structured selection.
|
void |
run(ITextSelection selection)
Executes this actions with the given text selection.
|
void |
selectionChanged(ISelection selection)
Notifies this action that the given selection has changed.
|
void |
selectionChanged(IStructuredSelection selection)
Notifies this action that the given structured selection has changed.
|
void |
selectionChanged(ITextSelection selection)
Notifies this action that the given text selection has changed.
|
void |
selectionChanged(SelectionChangedEvent event) |
void |
setSpecialSelectionProvider(ISelectionProvider provider)
Sets a special selection provider which will be used instead of the site's selection provider.
|
void |
update(ISelection selection)
Updates the action's enablement state according to the given selection.
|
protected SelectionDispatchAction(IWorkbenchSite site)
Configure the action later using the set methods.
site
- the site this action is working onpublic IWorkbenchSite getSite()
public ISelection getSelection()
public Shell getShell()
public ISelectionProvider getSelectionProvider()
setSpecialSelectionProvider(ISelectionProvider)
.public void setSpecialSelectionProvider(ISelectionProvider provider)
provider
- a special selection provider which is used
instead of the site's selection provider or null
to use the site's
selection provider. Clients can for example use a ConvertingSelectionProvider
to first convert a selection before passing it to the action.public void update(ISelection selection)
selectionChanged
methods depending on the type of the passed selection.selection
- the selection this action is working onpublic void selectionChanged(IStructuredSelection selection)
selectionChanged(ISelection selection)
.selection
- the new selectionpublic void run(IStructuredSelection selection)
run(ISelection selection)
.selection
- the selectionpublic void selectionChanged(ITextSelection selection)
selectionChanged(ISelection selection)
.selection
- the new selectionpublic void run(ITextSelection selection)
run(ISelection selection)
.selection
- the selectionpublic void selectionChanged(ISelection selection)
false
.selection
- the new selectionpublic void run(ISelection selection)
selection
- the selectionpublic void run()
public void selectionChanged(SelectionChangedEvent event)
Copyright (c) IBM Corp. and others 2000, 2016. All Rights Reserved.