org.eclipse.jface.preference
Class PreferenceManager

java.lang.Object
  |
  +--org.eclipse.jface.preference.PreferenceManager

public class PreferenceManager

extends Object

A preference manager maintains a hierarchy of preference nodes and associated preference pages.

Field Summary

static int	POST_ORDER Post-order means visit the children, and then the root.
static int	PRE_ORDER Pre-order traversal means visit the root first, then the children.

Constructor Summary

PreferenceManager()
Creates a new preference manager.

PreferenceManager(char separatorChar)
Creates a new preference manager with the given the path separator.

Method Summary

boolean	addTo(String path, IPreferenceNode node) Adds the given preference node as a subnode of the node at the given path.
void	addToRoot(IPreferenceNode node) Adds the given preference node as a subnode of the root.
protected void	buildSequence(IPreferenceNode node, List sequence, int order) Recursively enumerates all nodes at or below the given node and adds them to the given list in the given order.
IPreferenceNode	find(String path) Finds and returns the contribution node at the given path.
List	getElements(int order) Returns all preference nodes managed by this manager.
protected IPreferenceNode	getRoot() Returns the root node.
boolean	remove(IPreferenceNode node) Removes the given prefreence node if it is managed by this contribution manager.
IPreferenceNode	remove(String path) Removes the prefernece node at the given path.
void	removeAll() Removes all contribution nodes known to this manager.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PRE_ORDER

public static final int PRE_ORDER

Pre-order traversal means visit the root first, then the children.

See Also:

Constant Field Values

POST_ORDER

public static final int POST_ORDER

Post-order means visit the children, and then the root.

See Also:

Constant Field Values

Constructor Detail

PreferenceManager

public PreferenceManager()

Creates a new preference manager.

PreferenceManager

public PreferenceManager(char separatorChar)

Creates a new preference manager with the given the path separator.

Parameters:

separatorChar - the separator character

Method Detail

addTo

public boolean addTo(String path,
                     IPreferenceNode node)

Adds the given preference node as a subnode of the node at the given path.

Parameters:

path - the path

node - the node to add

Returns:

true if the add was successful, and false if there is no contribution at the given path

addToRoot

public void addToRoot(IPreferenceNode node)

Adds the given preference node as a subnode of the root.

Parameters:

node - the node to add, which must implement IPreferenceNode

buildSequence

protected void buildSequence(IPreferenceNode node,
                             List sequence,
                             int order)

Recursively enumerates all nodes at or below the given node and adds them to the given list in the given order.

Parameters:

node - the starting node

sequence - a read-write list of preference nodes (element type: IPreferenceNode) in the given order

order - the traversal order, one of PRE_ORDER and POST_ORDER

find

public IPreferenceNode find(String path)

Finds and returns the contribution node at the given path.

Parameters:

path - the path

Returns:

the node, or null if none

getElements

public List getElements(int order)

Returns all preference nodes managed by this manager.

Parameters:

order - the traversal order, one of PRE_ORDER and POST_ORDER

Returns:

a list of preference nodes (element type: IPreferenceNode) in the given order

getRoot

protected IPreferenceNode getRoot()

Returns the root node. Note that the root node is a special internal node that is used to collect together all the nodes that have no parent; it is not given out to clients.

Returns:

the root node

remove

public IPreferenceNode remove(String path)

Removes the prefernece node at the given path.

Parameters:

path - the path

Returns:

the node that was removed, or null if there was no node at the given path

remove

public boolean remove(IPreferenceNode node)

Removes the given prefreence node if it is managed by this contribution manager.

Parameters:

node - the node to remove

Returns:

true if the node was removed, and false otherwise

removeAll

public void removeAll()

Removes all contribution nodes known to this manager.