DefaultTreeModel (Java SE 15 & JDK 15) (original) (raw)
All Implemented Interfaces:
[Serializable](../../../../java.base/java/io/Serializable.html "interface in java.io")
, [TreeModel](TreeModel.html "interface in javax.swing.tree")
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 has been added to the java.beans
package. Please see XMLEncoder.
Field Summary
Fields
Modifier and Type | Field | 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 | 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
Modifier and Type | Method | 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 listenerType) | Returns an array of all the objects currently registered as _Foo_Listeners 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 children's 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 declared in class java.lang.Object
[clone](../../../../java.base/java/lang/Object.html#clone%28%29), [equals](../../../../java.base/java/lang/Object.html#equals%28java.lang.Object%29), [finalize](../../../../java.base/java/lang/Object.html#finalize%28%29), [getClass](../../../../java.base/java/lang/Object.html#getClass%28%29), [hashCode](../../../../java.base/java/lang/Object.html#hashCode%28%29), [notify](../../../../java.base/java/lang/Object.html#notify%28%29), [notifyAll](../../../../java.base/java/lang/Object.html#notifyAll%28%29), [toString](../../../../java.base/java/lang/Object.html#toString%28%29), [wait](../../../../java.base/java/lang/Object.html#wait%28%29), [wait](../../../../java.base/java/lang/Object.html#wait%28long%29), [wait](../../../../java.base/java/lang/Object.html#wait%28long,int%29)
Field Details
root
Root of the tree.
listenerList
Listeners.
asksAllowsChildren
protected boolean asksAllowsChildren
Determines how theisLeaf
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 Details
DefaultTreeModel
Creates a tree in which any node can have children.
Parameters:
root
- a TreeNode object that is the root of the tree
See Also:
DefaultTreeModel(TreeNode, boolean)DefaultTreeModel
public DefaultTreeModel(TreeNode root, boolean asksAllowsChildren)
Creates a tree specifying whether any node can have children, or whether only certain nodes can have children.
Parameters:
root
- a TreeNode object that is the root of the tree
asksAllowsChildren
- a boolean, false if any node can have children, true if each node is asked to see if it can have children
See Also:
asksAllowsChildrenMethod Details
setAsksAllowsChildren
public void setAsksAllowsChildren(boolean newValue)
Sets whether or not to test leafness by asking getAllowsChildren() or isLeaf() to the TreeNodes. If newvalue is true, getAllowsChildren() is messaged, otherwise isLeaf() is messaged.
Parameters:
newValue
- if true, getAllowsChildren() is messaged, otherwise isLeaf() is messagedasksAllowsChildren
public boolean asksAllowsChildren()
Tells how leaf nodes are determined.
Returns:
true if only nodes which do not allow children are leaf nodes, false if nodes which have no children (even if allowed) are leaf nodes
See Also:
asksAllowsChildrensetRoot
public void setRoot(TreeNode root)
Sets the root toroot
. A nullroot
implies the tree is to display nothing, and is legal.
Parameters:
root
- new value of tree rootgetRoot
Returns the root of the tree. Returns null only if the tree has no nodes.
Specified by:
[getRoot](TreeModel.html#getRoot%28%29)
in interface[TreeModel](TreeModel.html "interface in javax.swing.tree")
Returns:
the root of the treegetIndexOfChild
public int getIndexOfChild(Object parent,Object child)
Returns the index of child in parent. If either the parent or child isnull
, returns -1.
Specified by:
[getIndexOfChild](TreeModel.html#getIndexOfChild%28java.lang.Object,java.lang.Object%29)
in interface[TreeModel](TreeModel.html "interface in javax.swing.tree")
Parameters:
parent
- a note in the tree, obtained from this data source
child
- the node we are interested in
Returns:
the index of the child in the parent, or -1 if either the parent or the child isnull
getChild
public Object getChild(Object parent, int index)
Returns the child of parent at index index in the parent's child array. parent must be a node previously obtained from this data source. This should not return null if index is a valid index for parent (that is index >= 0 &&index < getChildCount(parent)).
Specified by:
[getChild](TreeModel.html#getChild%28java.lang.Object,int%29)
in interface[TreeModel](TreeModel.html "interface in javax.swing.tree")
Parameters:
parent
- a node in the tree, obtained from this data source
index
- index of child to be returned
Returns:
the child of parent at index indexgetChildCount
public int getChildCount(Object parent)
Returns the number of children of parent. Returns 0 if the node is a leaf or if it has no children. parent must be a node previously obtained from this data source.
Specified by:
[getChildCount](TreeModel.html#getChildCount%28java.lang.Object%29)
in interface[TreeModel](TreeModel.html "interface in javax.swing.tree")
Parameters:
parent
- a node in the tree, obtained from this data source
Returns:
the number of children of the node parentisLeaf
public boolean isLeaf(Object node)
Returns whether the specified node is a leaf node. The way the test is performed depends on theaskAllowsChildren
setting.
Specified by:
[isLeaf](TreeModel.html#isLeaf%28java.lang.Object%29)
in interface[TreeModel](TreeModel.html "interface in javax.swing.tree")
Parameters:
node
- the node to check
Returns:
true if the node is a leaf node
See Also:
asksAllowsChildren, TreeModel.isLeaf(java.lang.Object)reload
public void reload()
Invoke this method if you've modified theTreeNode
s upon which this model depends. The model will notify all of its listeners that the model has changed.valueForPathChanged
public void valueForPathChanged(TreePath path,Object newValue)
This sets the user object of the TreeNode identified by path and posts a node changed. If you use custom user objects in the TreeModel you're going to need to subclass this and set the user object of the changed node to something meaningful.
Specified by:
[valueForPathChanged](TreeModel.html#valueForPathChanged%28javax.swing.tree.TreePath,java.lang.Object%29)
in interface[TreeModel](TreeModel.html "interface in javax.swing.tree")
Parameters:
path
- path to the node that the user has altered
newValue
- the new value from the TreeCellEditorinsertNodeInto
Invoked this to insert newChild at location index in parents children. This will then message nodesWereInserted to create the appropriate event. This is the preferred way to add children as it will create the appropriate event.
Parameters:
newChild
- child node to be inserted
parent
- node to which children new node will be added
index
- index of parent's childrenremoveNodeFromParent
Message this to remove node from its parent. This will message nodesWereRemoved to create the appropriate event. This is the preferred way to remove a node as it handles the event creation for you.
Parameters:
node
- the node to be removed from it's parrentnodeChanged
public void nodeChanged(TreeNode node)
Invoke this method after you've changed how node is to be represented in the tree.
Parameters:
node
- the changed nodereload
public void reload(TreeNode node)
Invoke this method if you've modified theTreeNode
s upon which this model depends. The model will notify all of its listeners that the model has changed below the given node.
Parameters:
node
- the node below which the model has changednodesWereInserted
public void nodesWereInserted(TreeNode node, int[] childIndices)
Invoke this method after you've inserted some TreeNodes into node. childIndices should be the index of the new elements and must be sorted in ascending order.
Parameters:
node
- parent node which children count been incremented
childIndices
- indexes of inserted childrennodesWereRemoved
public void nodesWereRemoved(TreeNode node, int[] childIndices,Object[] removedChildren)
Invoke this method after you've removed some TreeNodes from node. childIndices should be the index of the removed elements and must be sorted in ascending order. And removedChildren should be the array of the children objects that were removed.
Parameters:
node
- parent node which childred were removed
childIndices
- indexes of removed childs
removedChildren
- array of the children objects that were removednodesChanged
public 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.
Parameters:
node
- changed node
childIndices
- indexes of changed childrennodeStructureChanged
public void nodeStructureChanged(TreeNode node)
Invoke this method if you've totally changed the children of node and its children's children... This will post a treeStructureChanged event.
Parameters:
node
- changed nodegetPathToRoot
Builds the parents of node up to and including the root node, where the original node is the last element in the returned array. The length of the returned array gives the node's depth in the tree.
Parameters:
aNode
- the TreeNode to get the path for
Returns:
an array of TreeNodes giving the path from the rootgetPathToRoot
Builds the parents of node up to and including the root node, where the original node is the last element in the returned array. The length of the returned array gives the node's depth in the tree.
Parameters:
aNode
- the TreeNode to get the path for
depth
- an int giving the number of steps already taken towards the root (on recursive calls), used to size the returned array
Returns:
an array of TreeNodes giving the path from the root to the specified nodeaddTreeModelListener
Adds a listener for the TreeModelEvent posted after the tree changes.
Specified by:
[addTreeModelListener](TreeModel.html#addTreeModelListener%28javax.swing.event.TreeModelListener%29)
in interface[TreeModel](TreeModel.html "interface in javax.swing.tree")
Parameters:
l
- the listener to add
See Also:
removeTreeModelListener(javax.swing.event.TreeModelListener)removeTreeModelListener
Removes a listener previously added with addTreeModelListener().
Specified by:
[removeTreeModelListener](TreeModel.html#removeTreeModelListener%28javax.swing.event.TreeModelListener%29)
in interface[TreeModel](TreeModel.html "interface in javax.swing.tree")
Parameters:
l
- the listener to remove
See Also:
addTreeModelListener(javax.swing.event.TreeModelListener)getTreeModelListeners
Returns an array of all the tree model listeners registered on this model.
Returns:
all of this model'sTreeModelListener
s or an empty array if no tree model listeners are currently registered
Since:
1.4
See Also:
addTreeModelListener(javax.swing.event.TreeModelListener), removeTreeModelListener(javax.swing.event.TreeModelListener)fireTreeNodesChanged
protected void fireTreeNodesChanged(Object source,Object[] path, int[] childIndices,Object[] children)
Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created using the parameters passed into the fire method.
Parameters:
source
- the source of theTreeModelEvent
; typicallythis
path
- the path to the parent of the nodes that changed; usenull
to identify the root has changed
childIndices
- the indices of the changed elements
children
- the changed elementsfireTreeNodesInserted
protected void fireTreeNodesInserted(Object source,Object[] path, int[] childIndices,Object[] children)
Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created using the parameters passed into the fire method.
Parameters:
source
- the source of theTreeModelEvent
; typicallythis
path
- the path to the parent the nodes were added to
childIndices
- the indices of the new elements
children
- the new elementsfireTreeNodesRemoved
protected void fireTreeNodesRemoved(Object source,Object[] path, int[] childIndices,Object[] children)
Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created using the parameters passed into the fire method.
Parameters:
source
- the source of theTreeModelEvent
; typicallythis
path
- the path to the parent the nodes were removed from
childIndices
- the indices of the removed elements
children
- the removed elementsfireTreeStructureChanged
protected void fireTreeStructureChanged(Object source,Object[] path, int[] childIndices,Object[] children)
Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created using the parameters passed into the fire method.
Parameters:
source
- the source of theTreeModelEvent
; typicallythis
path
- the path to the parent of the structure that has changed; usenull
to identify the root has changed
childIndices
- the indices of the affected elements
children
- the affected elementsgetListeners
public <T extends EventListener> T[] getListeners(Class listenerType)
Returns an array of all the objects currently registered as_Foo_Listener
s upon this model._Foo_Listener
s are registered using theadd_Foo_Listener
method.
You can specify thelistenerType
argument with a class literal, such as_Foo_Listener.class
. For example, you can query aDefaultTreeModel
m
for its tree model listeners with the following code:
TreeModelListener[] tmls = (TreeModelListener[])(m.getListeners(TreeModelListener.class));
If no such listeners exist, this method returns an empty array.
Type Parameters:
T
- the listener type
Parameters:
listenerType
- the type of listeners requested
Returns:
an array of all objects registered as_Foo_Listener
s on this component, or an empty array if no such listeners have been added
Throws:
[ClassCastException](../../../../java.base/java/lang/ClassCastException.html "class in java.lang")
- iflistenerType
doesn't specify a class or interface that implementsjava.util.EventListener
Since:
1.3
See Also:
getTreeModelListeners()