public interface ISelectionService
A listener that wants to be notified when the selection becomes
null
must implement the INullSelectionListener
interface.
This service can be acquired from your service locator:
ISelectionService service = (ISelectionService) getSite().getService(ISelectionService.class);
ISelectionListener
,
INullSelectionListener
,
IServiceLocator.getService(Class)
Modifier and Type | Method and Description |
---|---|
void |
addPostSelectionListener(ISelectionListener listener)
Adds the given post selection listener.It is equivalent to selection
changed if the selection was triggered by the mouse but it has a
delay if the selection is triggered by the keyboard arrows.
|
void |
addPostSelectionListener(String partId,
ISelectionListener listener)
Adds a part-specific selection listener which is notified when selection changes
in the part with the given id.
|
void |
addSelectionListener(ISelectionListener listener)
Adds the given selection listener.
|
void |
addSelectionListener(String partId,
ISelectionListener listener)
Adds a part-specific selection listener which is notified when selection changes
in the part with the given id.
|
ISelection |
getSelection()
Returns the current selection in the active part.
|
ISelection |
getSelection(String partId)
Returns the current selection in the part with the given id.
|
void |
removePostSelectionListener(ISelectionListener listener)
Removes the given post selection listener.
|
void |
removePostSelectionListener(String partId,
ISelectionListener listener)
Removes the given part-specific post selection listener.
|
void |
removeSelectionListener(ISelectionListener listener)
Removes the given selection listener.
|
void |
removeSelectionListener(String partId,
ISelectionListener listener)
Removes the given part-specific selection listener.
|
void addSelectionListener(ISelectionListener listener)
Note: listeners should be removed when no longer necessary. If not, they will be removed when the IServiceLocator used to acquire this service is disposed.
listener
- a selection listenerremoveSelectionListener(ISelectionListener)
void addSelectionListener(String partId, ISelectionListener listener)
When the part is created, the listener is passed the part's initial selection.
When the part is disposed, the listener is passed a null
selection,
but only if the listener implements INullSelectionListener
.
Note: This will not correctly track editor parts as each editor does not have a unique partId.
Note: listeners should be removed when no longer necessary. If not, they will be removed when the IServiceLocator used to acquire this service is disposed.
partId
- the id of the part to tracklistener
- a selection listenerremoveSelectionListener(String, ISelectionListener)
void addPostSelectionListener(ISelectionListener listener)
Note: listeners should be removed when no longer necessary. If not, they will be removed when the IServiceLocator used to acquire this service is disposed.
listener
- a selection listenerremovePostSelectionListener(ISelectionListener)
void addPostSelectionListener(String partId, ISelectionListener listener)
When the part is created, the listener is passed the part's initial selection.
When the part is disposed, the listener is passed a null
selection,
but only if the listener implements INullSelectionListener
.
Note: This will not correctly track editor parts as each editor does not have a unique partId.
Note: listeners should be removed when no longer necessary. If not, they will be removed when the IServiceLocator used to acquire this service is disposed.
partId
- the id of the part to tracklistener
- a selection listenerremovePostSelectionListener(String, ISelectionListener)
ISelection getSelection()
null
.null
if undefinedISelection getSelection(String partId)
null
.partId
- the id of the partnull
if undefinedvoid removeSelectionListener(ISelectionListener listener)
listener
- a selection listenervoid removeSelectionListener(String partId, ISelectionListener listener)
partId
- the id of the part to tracklistener
- a selection listenervoid removePostSelectionListener(ISelectionListener listener)
listener
- a selection listenervoid removePostSelectionListener(String partId, ISelectionListener listener)
partId
- the id of the part to tracklistener
- a selection listener
Copyright (c) 2000, 2015 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.