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

一个使用TreeNodes的简单树数据模型。 有关使用DefaultTreeModel的更多信息和示例，请参阅Java教程中的 How to Use Trees 。

警告：此类的序列化对象与将来的Swing版本不兼容。 当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。 从1.4开始，对所有JavaBeans的长期存储的支持已经添加到java.beans包中。 请参阅XMLEncoder 。

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	asksAllowsChildren 确定 isLeaf方法如何确定节点是否为叶节点。
protected EventListenerList	listenerList 听众。
protected TreeNode	root 树的根。

构造方法摘要

构造方法

Constructor and Description
DefaultTreeModel(TreeNode root) 创建一个树，其中任何节点可以拥有子节点。
DefaultTreeModel(TreeNode root, boolean asksAllowsChildren) 创建一个树，指定任何节点是否可以有子节点，或者只有某些节点可以有子节点。

方法摘要

Modifier and Type	Method and Description
void	addTreeModelListener(TreeModelListener l) 添加树树更改后发布的TreeModelEvent的侦听器。
boolean	asksAllowsChildren() 告诉叶节点如何确定。
protected void	fireTreeNodesChanged(Object source, Object[] path, int[] childIndices, Object[] children) 通知所有在此事件类型上通知有兴趣的听众。
protected void	fireTreeNodesInserted(Object source, Object[] path, int[] childIndices, Object[] children) 通知所有在此事件类型上通知有兴趣的听众。
protected void	fireTreeNodesRemoved(Object source, Object[] path, int[] childIndices, Object[] children) 通知所有在此事件类型上通知有兴趣的听众。
protected void	fireTreeStructureChanged(Object source, Object[] path, int[] childIndices, Object[] children) 通知所有在此事件类型上通知有兴趣的听众。
Object	getChild(Object parent, int index) 返回父节点的子数组中的 父索引 的索引孩子。
int	getChildCount(Object parent) 返回 父节点的子节点数。
int	getIndexOfChild(Object parent, Object child) 返回父项中的子项的索引。
<T extends EventListener> T[]	getListeners(类<T> listenerType) 返回当前注册为 FooListener的所有对象的数组。
TreeNode[]	getPathToRoot(TreeNode aNode) 构建节点直到并包括根节点的父节点，其中原始节点是返回的数组中的最后一个元素。
protected TreeNode[]	getPathToRoot(TreeNode aNode, int depth) 构建节点直到并包括根节点的父节点，其中原始节点是返回的数组中的最后一个元素。
Object	getRoot() 返回树的根。
TreeModelListener[]	getTreeModelListeners() 返回在此模型上注册的所有树模型侦听器的数组。
void	insertNodeInto(MutableTreeNode newChild, MutableTreeNode parent, int index) 调用此选项将parentChild插入到父项子节点的位置索引中。
boolean	isLeaf(Object node) 返回指定节点是否为叶节点。
void	nodeChanged(TreeNode node) 在更改树中如何表示节点之后调用此方法。
void	nodesChanged(TreeNode node, int[] childIndices) 在更改了如何在树中表示由childIndicies标识的子项后调用此方法。
void	nodeStructureChanged(TreeNode node) 如果您完全改变了节点及其子节点的子节点，则调用此方法
void	nodesWereInserted(TreeNode node, int[] childIndices) 在将一些TreeNodes插入节点后调用此方法。
void	nodesWereRemoved(TreeNode node, int[] childIndices, Object[] removedChildren) 从节点中删除一些TreeNodes后，调用此方法。
void	reload() 如果您修改了此型号所依赖的 TreeNode ，则调用此方法。
void	reload(TreeNode node) 如果您修改了此型号所依赖的 TreeNode ，则调用此方法。
void	removeNodeFromParent(MutableTreeNode node) 消息此消息从其父节点删除节点。
void	removeTreeModelListener(TreeModelListener l) 删除之前使用 addTreeModelListener（）添加的监听器。
void	setAsksAllowsChildren(boolean newValue) 设置是否通过向TreeNodes请求getAllowsChildren（）或isLeaf（）来测试叶片性。
void	setRoot(TreeNode root) 将根设置为 root 。
void	valueForPathChanged(TreePath path, Object newValue) 这设置由路径标识的TreeNode的用户对象，并发布一个节点更改。

Methods inherited from class java.lang.Object

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

字段详细信息

root

protected TreeNode root

树的根。

listenerList

protected EventListenerList listenerList

听众。

asksAllowsChildren

protected boolean asksAllowsChildren

确定isLeaf方法如果节点是叶节点，则isLeaf 。 如果为true，则如果节点不允许孩子，则节点是叶节点。 （如果它允许孩子，它不是一个叶节点，即使没有孩子）。例如，您可以区分文件系统中的文件夹节点和文件节点。

如果该值为false，则任何没有子节点的节点都是叶节点，任何节点都可以获取子节点。

另请参见：

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

构造方法详细信息

DefaultTreeModel

@ConstructorProperties(value="root")
public DefaultTreeModel(TreeNode root)

创建一个树，其中任何节点可以拥有子节点。

参数

root - 作为 root的TreeNode对象

另请参见：

DefaultTreeModel(TreeNode, boolean)

DefaultTreeModel

public DefaultTreeModel(TreeNode root,
                        boolean asksAllowsChildren)

创建一个树，指定任何节点是否可以有子节点，或者只有某些节点可以有子节点。

参数

root - 作为 root的TreeNode对象

asksAllowsChildren - 一个布尔值，如果任何一个节点可以有子节点，则为false，如果要求每个节点查看是否有子节点，则为true

另请参见：

asksAllowsChildren

方法详细信息

setAsksAllowsChildren

public void setAsksAllowsChildren(boolean newValue)

设置是否通过向TreeNodes请求getAllowsChildren（）或isLeaf（）来测试叶片性。 如果newvalue为true，则getAllowsChildren（）将被消息，否则isLeaf（）被消息。

asksAllowsChildren

public boolean asksAllowsChildren()

告诉叶节点如何确定。

结果

如果只有不允许子节点的节点是叶节点，则为真，如果没有子节点的节点（即使是允许的话）也是假叶节点

另请参见：

asksAllowsChildren

setRoot

public void setRoot(TreeNode root)

将根设置为root 。 一个null root意味着树是不显示，是合法的。

getRoot

public Object getRoot()

返回树的根。 只有当树没有节点时才返回null。

Specified by:

getRoot在接口 TreeModel

结果

树的根

getIndexOfChild

public int getIndexOfChild(Object parent,
                           Object child)

返回父项中的子项的索引。 如果父或者孩子是null ，返回-1。

Specified by:

getIndexOfChild在界面 TreeModel

参数

parent - 从该数据源获取的树中的一个注释

child - 我们感兴趣的节点

结果

父母中的孩子的索引，如果父母或孩子的父母为 null

getChild

public Object getChild(Object parent,
                       int index)

返回父节点的子数组中的父索引的索引孩子。 父项必须是先前从此数据源获取的节点。 如果index是parent的有效索引（即index > = 0 && index <getChildCount（ parent ）），则不应返回null。

Specified by:

getChild在接口 TreeModel

参数

parent - 从该数据源获取的树中的一个节点

结果

父母的索引 索引小孩

getChildCount

public int getChildCount(Object parent)

返回父节点的子节点数。 如果节点是叶子或没有子节点，则返回0。 父项必须是先前从此数据源获取的节点。

Specified by:

getChildCount在界面 TreeModel

参数

parent - 从该数据源获取的树中的一个节点

结果

节点 父节点的 子节点数

isLeaf

public boolean isLeaf(Object node)

返回指定节点是否为叶节点。 执行测试的方式取决于askAllowsChildren设置。

Specified by:

isLeaf在接口 TreeModel

参数

node - 要检查的节点

结果

如果节点是叶节点，则为true

另请参见：

asksAllowsChildren ， TreeModel.isLeaf(java.lang.Object)

reload

public void reload()

如果您修改了此型号所依赖的TreeNode ，则调用此方法。 该模型将通知所有的监听器模型已经改变。

valueForPathChanged

public void valueForPathChanged(TreePath path,
                                Object newValue)

这设置由路径标识的TreeNode的用户对象，并发布一个节点更改。 如果您在TreeModel中使用自定义用户对象，则需要对其进行子类化，并将更改的节点的用户对象设置为有意义的对象。

Specified by:

valueForPathChanged在界面 TreeModel

参数

path - 用户已更改的节点的路径

newValue - newValue的新值

insertNodeInto

public void insertNodeInto(MutableTreeNode newChild,
                           MutableTreeNode parent,
                           int index)

调用此选项将parentChild插入到父项子节点的位置索引中。 这将会消息节点被插入以创建适当的事件。 这是添加子项的首选方法，因为它将创建适当的事件。

removeNodeFromParent

public void removeNodeFromParent(MutableTreeNode node)

消息此消息从其父节点删除节点。 这将消息节点被删除以创建适当的事件。 这是在为您处理事件创建时删除节点的首选方法。

nodeChanged

public void nodeChanged(TreeNode node)

在更改树中如何表示节点之后调用此方法。

reload

public void reload(TreeNode node)

如果您修改了此型号所依赖的TreeNode ，则调用此方法。 该模型将通知所有的监听器模型已经在给定节点之下变化。

参数

node - 模型 node的节点已更改

nodesWereInserted

public void nodesWereInserted(TreeNode node,
                              int[] childIndices)

在将一些TreeNodes插入节点后调用此方法。 childIndices应该是新元素的索引，必须按升序排序。

nodesWereRemoved

public void nodesWereRemoved(TreeNode node,
                             int[] childIndices,
                             Object[] removedChildren)

从节点中删除一些TreeNodes后，调用此方法。 childIndices应该是已删除元素的索引，并且必须按升序排序。 而removeChildren应该是删除的子对象的数组。

nodesChanged

public void nodesChanged(TreeNode node,
                         int[] childIndices)

在更改了如何在树中表示由childIndicies标识的子项后调用此方法。

nodeStructureChanged

public void nodeStructureChanged(TreeNode node)

如果您完全更改了节点及其子节点的子节点，则调用此方法...将发布一个treeStructureChanged事件。

getPathToRoot

public TreeNode[] getPathToRoot(TreeNode aNode)

构建节点直到并包括根节点的父节点，其中原始节点是返回的数组中的最后一个元素。 返回的数组的长度给出了节点在树中的深度。

参数

aNode - 获取路径的TreeNode

getPathToRoot

protected TreeNode[] getPathToRoot(TreeNode aNode,
                                   int depth)

构建节点直到并包括根节点的父节点，其中原始节点是返回的数组中的最后一个元素。 返回的数组的长度给出了节点在树中的深度。

参数

aNode - 获取路径的TreeNode

depth - 一个int给出已经为根（在递归调用）上已经采取的步骤数，用于调整返回的数组的大小

结果

一个TreeNodes数组，提供从根到指定节点的路径

addTreeModelListener

public void addTreeModelListener(TreeModelListener l)

添加树树更改后发布的TreeModelEvent的侦听器。

Specified by:

addTreeModelListener在界面 TreeModel

参数

l - 要添加的监听器

另请参见：

removeTreeModelListener(javax.swing.event.TreeModelListener)

removeTreeModelListener

public void removeTreeModelListener(TreeModelListener l)

删除之前使用 addTreeModelListener（）添加的监听器。

Specified by:

removeTreeModelListener在界面 TreeModel

参数

l - 要删除的侦听器

另请参见：

addTreeModelListener(javax.swing.event.TreeModelListener)

getTreeModelListeners

public TreeModelListener[] getTreeModelListeners()

返回在此模型上注册的所有树模型侦听器的数组。

结果

所有这个模型的 TreeModelListener s或一个空数组，如果没有树模型侦听器当前注册

从以下版本开始：

1.4

另请参见：

addTreeModelListener(javax.swing.event.TreeModelListener) ， removeTreeModelListener(javax.swing.event.TreeModelListener)

fireTreeNodesChanged

protected void fireTreeNodesChanged(Object source,
                                    Object[] path,
                                    int[] childIndices,
                                    Object[] children)

通知所有在此事件类型上通知有兴趣的听众。 事件实例使用传递给fire方法的参数进行懒惰创建。

参数

source - 源的TreeModelEvent ; 通常为this

path - 改变节点的父节点的路径; 使用null来识别根已经改变

childIndices - 变化元素的指标

children - 已更改的元素

fireTreeNodesInserted

protected void fireTreeNodesInserted(Object source,
                                     Object[] path,
                                     int[] childIndices,
                                     Object[] children)

通知所有在此事件类型上通知有兴趣的听众。 事件实例使用传递给fire方法的参数进行懒惰创建。

参数

source - 源的TreeModelEvent ; 通常为this

path - 添加到节点的父节点的路径

childIndices - 新元素的指标

children - 新元素

fireTreeNodesRemoved

protected void fireTreeNodesRemoved(Object source,
                                    Object[] path,
                                    int[] childIndices,
                                    Object[] children)

通知所有在此事件类型上通知有兴趣的听众。 事件实例使用传递给fire方法的参数进行懒惰创建。

参数

source - 源的TreeModelEvent ; 通常为this

path - 从父节点删除节点的路径

childIndices - 已移除元素的索引

children - 删除的元素

fireTreeStructureChanged

protected void fireTreeStructureChanged(Object source,
                                        Object[] path,
                                        int[] childIndices,
                                        Object[] children)

通知所有在此事件类型上通知有兴趣的听众。 事件实例使用传递给fire方法的参数进行懒惰创建。

参数

source - 源的TreeModelEvent ; 通常为this

path - 已更改的结构的父对象的路径; 使用null来识别根已经改变

childIndices - 受影响元素的指标

children - 受影响的元素

getListeners

public <T extends EventListener> T[] getListeners(类<T> listenerType)

返回当前注册为FooListener的所有对象的数组。 FooListener使用addFooListener 。

您可以使用类文字指定listenerType参数，例如FooListener.class 。 例如，您可以查询DefaultTreeModel m与下面的代码的树模型侦听器：

  TreeModelListener[] tmls = (TreeModelListener[])(m.getListeners(TreeModelListener.class)); 

如果没有这样的侦听器存在，这个方法返回一个空数组。

参数

listenerType - 所请求的听众的类型; 该参数应指定从java.util.EventListener下降的java.util.EventListener

结果

在该组件上注册为 FooListener的所有对象的数组，如果没有添加此类侦听器，则为空数组

异常

ClassCastException - 如果 listenerType没有指定实现java.util.EventListener的类或 java.util.EventListener

从以下版本开始：

1.3

另请参见：

getTreeModelListeners()