DefaultTreeModel (Java Platform SE 8 )

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()

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class DefaultTreeModel

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

root

listenerList

asksAllowsChildren

构造方法详细信息

DefaultTreeModel

DefaultTreeModel

方法详细信息

setAsksAllowsChildren

asksAllowsChildren

setRoot

getRoot

getIndexOfChild

getChild

getChildCount

isLeaf

reload

valueForPathChanged

insertNodeInto

removeNodeFromParent

nodeChanged

reload

nodesWereInserted

nodesWereRemoved

nodesChanged

nodeStructureChanged

getPathToRoot

getPathToRoot

addTreeModelListener

removeTreeModelListener

getTreeModelListeners

fireTreeNodesChanged

fireTreeNodesInserted

fireTreeNodesRemoved

fireTreeStructureChanged

getListeners