public interface IEclipsePreferences extends Preferences
Clients may implement this interface.
Preferences| Modifier and Type | Interface and Description |
|---|---|
static interface |
IEclipsePreferences.INodeChangeListener
A listener to be used to receive preference node change events.
|
static interface |
IEclipsePreferences.IPreferenceChangeListener
A listener used to receive changes to preference values in the preference store.
|
static class |
IEclipsePreferences.NodeChangeEvent
An event object which describes the details of a change in the
preference node hierarchy.
|
static class |
IEclipsePreferences.PreferenceChangeEvent
An event object describing the details of a change to a preference
in the preference store.
|
| Modifier and Type | Method and Description |
|---|---|
void |
accept(IPreferenceNodeVisitor visitor)
Accepts the given visitor.
|
void |
addNodeChangeListener(IEclipsePreferences.INodeChangeListener listener)
Register the given listener for changes to this node.
|
void |
addPreferenceChangeListener(IEclipsePreferences.IPreferenceChangeListener listener)
Register the given listener for notification of preference changes to this node.
|
Preferences |
node(String path)
Return the preferences node with the given path.
|
void |
removeNode()
Remove this node from the preference hierarchy.
|
void |
removeNodeChangeListener(IEclipsePreferences.INodeChangeListener listener)
De-register the given listener from receiving event change notifications
for this node.
|
void |
removePreferenceChangeListener(IEclipsePreferences.IPreferenceChangeListener listener)
De-register the given listener from receiving notification of preference changes
to this node.
|
absolutePath, childrenNames, clear, flush, get, getBoolean, getByteArray, getDouble, getFloat, getInt, getLong, keys, name, nodeExists, parent, put, putBoolean, putByteArray, putDouble, putFloat, putInt, putLong, remove, syncvoid addNodeChangeListener(IEclipsePreferences.INodeChangeListener listener)
null.listener - the node change listener to addIllegalStateException - if this node or an ancestor has been removedremoveNodeChangeListener(IEclipsePreferences.INodeChangeListener),
IEclipsePreferences.INodeChangeListenervoid removeNodeChangeListener(IEclipsePreferences.INodeChangeListener listener)
null.listener - the node change listener to removeIllegalStateException - if this node or an ancestor has been removedaddNodeChangeListener(IEclipsePreferences.INodeChangeListener),
IEclipsePreferences.INodeChangeListenervoid addPreferenceChangeListener(IEclipsePreferences.IPreferenceChangeListener listener)
null.listener - the preference change listener to registerIllegalStateException - if this node or an ancestor has been removedremovePreferenceChangeListener(IEclipsePreferences.IPreferenceChangeListener),
IEclipsePreferences.IPreferenceChangeListenervoid removePreferenceChangeListener(IEclipsePreferences.IPreferenceChangeListener listener)
null.listener - the preference change listener to removeIllegalStateException - if this node or an ancestor has been removedaddPreferenceChangeListener(IEclipsePreferences.IPreferenceChangeListener),
IEclipsePreferences.IPreferenceChangeListenervoid removeNode()
throws BackingStoreException
Functionally equivalent to calling Preferences.removeNode().
See the spec of Preferences.removeNode() for more details.
Implementors must send the appropriate IEclipsePreferences.NodeChangeEvent
to listeners who are registered on this node's parent.
When this node is removed, its associated preference and node change listeners should be removed as well.
removeNode in interface PreferencesBackingStoreException - if there was a problem removing this nodePreferences.removeNode(),
IEclipsePreferences.NodeChangeEventPreferences node(String path)
null.
See the spec of Preferences.node(String) for more details.
Note that if the node does not yet exist and is created, then the appropriate
IEclipsePreferences.NodeChangeEvent must be sent to listeners who are
registered at this node.
node in interface Preferencespath - the path of the nodePreferences.node(String),
IEclipsePreferences.NodeChangeEventvoid accept(IPreferenceNodeVisitor visitor) throws BackingStoreException
visit method
is called with this node. If the visitor returns true,
this method visits this node's children.visitor - the visitorBackingStoreExceptionIPreferenceNodeVisitor.visit(IEclipsePreferences)Guidelines for using Eclipse APIs. Copyright (c) IBM Corp. and others 2000, 2006. All rights reserved.