W3cubDocs

/OpenJDK 21

Class JTree.DynamicUtilTreeNode

java.lang.Object
javax.swing.tree.DefaultMutableTreeNode
javax.swing.JTree.DynamicUtilTreeNode
All Implemented Interfaces:
Serializable, Cloneable, MutableTreeNode, TreeNode
Enclosing class:
JTree
public static class JTree.DynamicUtilTreeNode extends DefaultMutableTreeNode
DynamicUtilTreeNode can wrap vectors/hashtables/arrays/strings and create the appropriate children tree nodes as necessary. It is dynamic in that it will only create the children as necessary.

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

Modifier and Type Field Description
protected Object childValue
Value to create children with.
protected boolean hasChildren
Does the this JTree have children?
protected boolean loadedChildren
Have the children been loaded yet?

Fields declared in class javax.swing.tree.DefaultMutableTreeNode

allowsChildren, children, EMPTY_ENUMERATION, parent, userObject

Constructor Summary

Constructor Description
DynamicUtilTreeNode(Object value, Object children)
Creates a node with the specified object as its value and with the specified children.

Method Summary

Modifier and Type Method Description
Enumeration<TreeNode> children()
Subclassed to load the children, if necessary.
static void createChildren(DefaultMutableTreeNode parent, Object children)
Adds to parent all the children in children.
TreeNode getChildAt(int index)
Subclassed to load the children, if necessary.
int getChildCount()
Returns the number of child nodes.
boolean isLeaf()
Returns true if this node allows children.
protected void loadChildren()
Loads the children based on childValue.

Methods declared in class java.lang.Object

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

Field Details

hasChildren

protected boolean hasChildren
Does the this JTree have children? This property is currently not implemented.

childValue

protected Object childValue
Value to create children with.

loadedChildren

protected boolean loadedChildren
Have the children been loaded yet?

Constructor Details

DynamicUtilTreeNode

public DynamicUtilTreeNode(Object value, Object children)
Creates a node with the specified object as its value and with the specified children. For the node to allow children, the children-object must be an array of objects, a Vector, or a Hashtable -- even if empty. Otherwise, the node is not allowed to have children.
Parameters:
value - the Object that is the value for the new node
children - an array of Objects, a Vector, or a Hashtable used to create the child nodes; if any other object is specified, or if the value is null, then the node is not allowed to have children

Method Details

createChildren

public static void createChildren(DefaultMutableTreeNode parent, Object children)
Adds to parent all the children in children. If children is an array or vector all of its elements are added is children, otherwise if children is a hashtable all the key/value pairs are added in the order Enumeration returns them.
Parameters:
parent - the parent node
children - the children

isLeaf

public boolean isLeaf()
Returns true if this node allows children. Whether the node allows children depends on how it was created.
Specified by:
isLeaf in interface TreeNode
Overrides:
isLeaf in class DefaultMutableTreeNode
Returns:
true if this node allows children, false otherwise
See Also:

getChildCount

public int getChildCount()
Returns the number of child nodes.
Specified by:
getChildCount in interface TreeNode
Overrides:
getChildCount in class DefaultMutableTreeNode
Returns:
the number of child nodes

loadChildren

protected void loadChildren()
Loads the children based on childValue. If childValue is a Vector or array each element is added as a child, if childValue is a Hashtable each key/value pair is added in the order that Enumeration returns the keys.

getChildAt

public TreeNode getChildAt(int index)
Subclassed to load the children, if necessary.
Specified by:
getChildAt in interface TreeNode
Overrides:
getChildAt in class DefaultMutableTreeNode
Parameters:
index - an index into this node's child array
Returns:
the TreeNode in this node's child array at the specified index

children

public Enumeration<TreeNode> children()
Subclassed to load the children, if necessary.
Specified by:
children in interface TreeNode
Overrides:
children in class DefaultMutableTreeNode
Returns:
an Enumeration of this node's children

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/JTree.DynamicUtilTreeNode.html