public abstract class PreferenceModifyListener extends Object
org.eclipse.core.runtime.preferences
extension point.
Clients may subclass this type.
| Constructor and Description |
|---|
PreferenceModifyListener() |
| Modifier and Type | Method and Description |
|---|---|
IEclipsePreferences |
preApply(IEclipsePreferences node)
Clients are given the opportunity to modify the given tree before it is applied
to the global preference tree.
|
public IEclipsePreferences preApply(IEclipsePreferences node)
null and clients
must not return a null tree.
This method is called by the preference service from within calls to
IPreferencesService.applyPreferences(IExportedPreferences) or
IPreferencesService.applyPreferences(IEclipsePreferences, IPreferenceFilter[]).
A typical action for clients to perform would be to intercept the incoming preference tree, migrate old preference values to new ones, and then return the new tree.
node - the tree to modifyGuidelines for using Eclipse APIs. Copyright (c) IBM Corp. and others 2000, 2006. All rights reserved.