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, 2014 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.