org.eclipse.ui
Interface IServiceWithSources

All Known Subinterfaces:

IContextService, IHandlerService

public interface IServiceWithSources

A service that responds to changes in one or more sources. These sources can be plugged into the service.

This interface should not be implemented or extended by clients.

EXPERIMENTAL. This class or interface has been added as part of a work in progress. There is a guarantee neither that this API will work nor that it will remain the same. Please do not use this API without consulting with the Platform/UI team.

Since:

3.2

Method Summary

void	addSourceProvider(ISourceProvider provider) Adds a source provider to this service.
void	removeSourceProvider(ISourceProvider provider) Removes a source provider from this service.

Method Detail

addSourceProvider

public void addSourceProvider(ISourceProvider provider)

Adds a source provider to this service. A source provider will notify the service when the source it provides changes. An example of a source might be an active editor or the current selection. This amounts to a pluggable state tracker for the service.

Parameters:

provider - The provider to add; must not be null.

removeSourceProvider

public void removeSourceProvider(ISourceProvider provider)

Removes a source provider from this service. Most of the time, this method call is not required as source providers typically share the same life span as the workbench itself.

Parameters:

provider - The provider to remove; must not be null.