javax.swing.tree

Class DefaultTreeModel

java.lang.Object

javax.swing.tree.DefaultTreeModel

All Implemented Interfaces:

Serializable, TreeModel

public class DefaultTreeModel
extends Object
implements Serializable, TreeModel

A simple tree data model that uses TreeNodes. For further information and examples that use DefaultTreeModel, see How to Use Trees in The Java Tutorial.

Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeans^TM has been added to the java.beans package. Please see XMLEncoder.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	asksAllowsChildren Determines how the isLeaf method figures out if a node is a leaf node.
protected EventListenerList	listenerList Listeners.
protected TreeNode	root Root of the tree.

Constructor Summary

Constructors

Constructor and Description
DefaultTreeModel(TreeNode root) Creates a tree in which any node can have children.
DefaultTreeModel(TreeNode root, boolean asksAllowsChildren) Creates a tree specifying whether any node can have children, or whether only certain nodes can have children.

Method Summary

Methods

Modifier and Type	Method and Description
void	addTreeModelListener(TreeModelListener l) Adds a listener for the TreeModelEvent posted after the tree changes.
boolean	asksAllowsChildren() Tells how leaf nodes are determined.
protected void	fireTreeNodesChanged(Object source, Object[] path, int[] childIndices, Object[] children) Notifies all listeners that have registered interest for notification on this event type.
protected void	fireTreeNodesInserted(Object source, Object[] path, int[] childIndices, Object[] children) Notifies all listeners that have registered interest for notification on this event type.
protected void	fireTreeNodesRemoved(Object source, Object[] path, int[] childIndices, Object[] children) Notifies all listeners that have registered interest for notification on this event type.
protected void	fireTreeStructureChanged(Object source, Object[] path, int[] childIndices, Object[] children) Notifies all listeners that have registered interest for notification on this event type.
Object	getChild(Object parent, int index) Returns the child of parent at index index in the parent's child array.
int	getChildCount(Object parent) Returns the number of children of parent.
int	getIndexOfChild(Object parent, Object child) Returns the index of child in parent.
<T extends EventListener> T[]	getListeners(Class<T> listenerType) Returns an array of all the objects currently registered as FooListeners upon this model.
TreeNode[]	getPathToRoot(TreeNode aNode) Builds the parents of node up to and including the root node, where the original node is the last element in the returned array.
protected TreeNode[]	getPathToRoot(TreeNode aNode, int depth) Builds the parents of node up to and including the root node, where the original node is the last element in the returned array.
Object	getRoot() Returns the root of the tree.
TreeModelListener[]	getTreeModelListeners() Returns an array of all the tree model listeners registered on this model.
void	insertNodeInto(MutableTreeNode newChild, MutableTreeNode parent, int index) Invoked this to insert newChild at location index in parents children.
boolean	isLeaf(Object node) Returns whether the specified node is a leaf node.
void	nodeChanged(TreeNode node) Invoke this method after you've changed how node is to be represented in the tree.
void	nodesChanged(TreeNode node, int[] childIndices) Invoke this method after you've changed how the children identified by childIndicies are to be represented in the tree.
void	nodeStructureChanged(TreeNode node) Invoke this method if you've totally changed the children of node and its childrens children...
void	nodesWereInserted(TreeNode node, int[] childIndices) Invoke this method after you've inserted some TreeNodes into node.
void	nodesWereRemoved(TreeNode node, int[] childIndices, Object[] removedChildren) Invoke this method after you've removed some TreeNodes from node.
void	reload() Invoke this method if you've modified the TreeNodes upon which this model depends.
void	reload(TreeNode node) Invoke this method if you've modified the TreeNodes upon which this model depends.
void	removeNodeFromParent(MutableTreeNode node) Message this to remove node from its parent.
void	removeTreeModelListener(TreeModelListener l) Removes a listener previously added with addTreeModelListener().
void	setAsksAllowsChildren(boolean newValue) Sets whether or not to test leafness by asking getAllowsChildren() or isLeaf() to the TreeNodes.
void	setRoot(TreeNode root) Sets the root to root.
void	valueForPathChanged(TreePath path, Object newValue) This sets the user object of the TreeNode identified by path and posts a node changed.

Methods inherited from class java.lang.Object

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

Field Detail

root

protected TreeNode root

Root of the tree.

listenerList

protected EventListenerList listenerList

Listeners.

asksAllowsChildren

protected boolean asksAllowsChildren

Determines how the isLeaf method figures out if a node is a leaf node. If true, a node is a leaf node if it does not allow children. (If it allows children, it is not a leaf node, even if no children are present.) That lets you distinguish between folder nodes and file nodes in a file system, for example.

If this value is false, then any node which has no children is a leaf node, and any node may acquire children.

See Also:

TreeNode.getAllowsChildren(), TreeModel.isLeaf(java.lang.Object), setAsksAllowsChildren(boolean)

Constructor Detail

DefaultTreeModel