javax.swing.event

Class TreeModelEvent

java.lang.Object

java.util.EventObject

javax.swing.event.TreeModelEvent

All Implemented Interfaces:

Serializable

public class TreeModelEvent
extends EventObject

封装描述变化到树模型的信息，并用于变动通知树模型的听众。更多的信息和例子见 How to Write a Tree Model Listener，java教程中的一部分。

警告：序列化该类的对象与以后的Swing版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为1.4，为所有JavaBeans™长期存储的支持已被添加到java.beans包。请看XMLEncoder。

Field Summary

Fields

Modifier and Type	Field and Description
protected int[]	childIndices 确定孩子所在位置的指标。
protected Object[]	children 已被移除的孩子。
protected TreePath	path 已更改的节点的父节点的路径。

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor and Description
TreeModelEvent(Object source, Object[] path) 用于创建一个事件时，节点的结构有一定的变化，确定路径的修改子树的根对象数组。
TreeModelEvent(Object source, Object[] path, int[] childIndices, Object[] children) 用于创建节点已被更改、插入或删除的事件，确定将修改后的项目的父对象的路径作为一个对象数组。
TreeModelEvent(Object source, TreePath path) 用于创建一个事件时，节点的结构有一定的变化，确定路径的修改子树的根为树路径对象。
TreeModelEvent(Object source, TreePath path, int[] childIndices, Object[] children) 用于创建一个事件时，节点被改变，插入或删除，确定路径的修改的项目作为对象的父树路径。

方法摘要

Modifier and Type	Method and Description
int[]	getChildIndices() 返回子索引的值。
Object[]	getChildren() 返回的节点确定在指定的位置 getPath getChildIndices儿童对象。
Object[]	getPath() 获取对象数组的实例，这一事件将树路径的便捷方法。
TreePath	getTreePath() 除了treestructurechanged所有事件，返回改变节点的父。
String	toString() 返回显示并标识该对象属性的字符串。

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

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

Field Detail

path

protected TreePath path

已更改的节点的父节点的路径。

childIndices

protected int[] childIndices

确定孩子所在位置的指标。

children

protected Object[] children

已被移除的孩子。

Constructor Detail

TreeModelEvent

public TreeModelEvent(Object source,
                      Object[] path,
                      int[] childIndices,
                      Object[] children)

用于创建节点已被更改、插入或删除的事件，确定将修改后的项目的父对象的路径作为一个对象数组。所有的修改的对象是兄弟姐妹的直接后裔（不是孙子）指定的父。在插入、删除的位置发生变化，或由指定 int数组，数组必须为指标，从最低到最高。

对于更改，模型中的索引完全对应于当前显示在用户界面中的项目的索引。因此，它不是真的关键，如果索引不在他们的确切顺序。但在多个插入或删除后，当前在用户界面中的项目不再与模型中的项目相对应。因此，关键是要正确指定插入和删除的索引。

对于插入，指标代表树的最终的状态，在插入时有发生。由于索引必须是指定的顺序，最自然的处理方法是做的插入开始在最低的指标，并朝着最高。积累的Integer对象指定插入位置为你的载体，将载体的int创建事件数组。当位置指数等于零，节点插入到列表的开始。当位置索引等于列表的大小时，节点将“插入”（附加到）列表的结尾。

对于删除的指标，代表树的最初的状态，在删除时有发生。由于索引必须是指定的顺序，最自然的处理方法是使用一个删除计数器。从柜台零初始化和启动工作从最低到最高的列表。你每次做删除、添加删除计数器，删除发生的索引位置的电流值，并将结果向量删除的位置，使用addElement()。然后增加删除计数器。存储在向量中的索引位置，因此反映了所有以前的删除的影响，所以它们代表了每个对象在初始树中的位置。（你也可以开始在最高指数和回到工作的最低，积累一个向量删除位置你去使用insertElementAt(Integer, 0)。）但是你产生初始位置的向量，然后你需要把Integer对象的矢量来int创建事件数组。

笔记:

• 喜欢在DefaultTreeModel班insertNodeInto方法，insertElementAt追加到Vector当指数相匹配的矢量的大小。所以你可以用insertElementAt(Integer, 0)即使向量是空的。
• 创建一个节点改变事件为根节点，指定父和子指标null。

参数

source负责生成事件的对象（通常是事件对象的创造者通过 this其价值）

path -物体识别路径的修正项的父数组（S），数组的第一个元素是存储在根节点对象和最后一个元素存储在父节点对象

childIndices - int指定删除的项的索引值的数组。该指数必须在排序顺序，从最低到最高

children -数组对象包含的插入，删除，或更改的对象

另请参见：

TreePath

TreeModelEvent

public TreeModelEvent(Object source,
                      TreePath path,
                      int[] childIndices,
                      Object[] children)

用于创建一个事件时，节点被改变，插入或删除，确定路径的修改的项目作为对象的父树路径。更多关于如何指定指标和对象，看 TreeModelEvent(Object,Object[],int[],Object[])。

参数

source负责生成事件的对象（通常是事件对象的创造者通过其价值 this）

path -树路径对象标识的修改项的父路径（S）

childIndices - int指定修改的项的索引值的数组

children -数组对象包含的插入，删除，或更改的对象

另请参见：

TreeModelEvent(Object,Object[],int[],Object[])

TreeModelEvent

public TreeModelEvent(Object source,
                      Object[] path)

用于创建一个事件时，节点的结构有一定的变化，确定路径的修改子树的根对象数组。一个结构变化事件可能涉及的节点交换位置，例如，或它可能封装多个插入和删除在来自节点的子树，那里的变化可能发生在不同层次的子树。

Note:
JTree collapses all nodes under the specified node, so that only its immediate children are visible.

参数

source负责生成事件的对象（通常是事件对象的创造者通过 this其价值）

path -物体识别路径的修改子树的根的数组，其中数组的第一个元素存储在根节点对象和最后一个元素存储在改变节点的对象

另请参见：

TreePath

TreeModelEvent

public TreeModelEvent(Object source,
                      TreePath path)

用于创建一个事件时，节点的结构有一定的变化，确定路径的修改子树的根为树路径对象。关于这一事件的规范的更多信息，见 TreeModelEvent(Object,Object[])。

参数

source负责生成事件的对象（通常是事件对象的创造者通过 this其价值）

path -树路径对象标识的改变路径。在defaulttreemodel，这个对象包含用户数据对象的数组，但树路径的子类可以使用一些完全不同的机制，例如，一个节点的ID号

另请参见：

TreeModelEvent(Object,Object[])

方法详细信息

getTreePath

public TreePath getTreePath()

除了treestructurechanged所有事件，返回改变节点的父。对于treestructurechanged事件，返回结构的祖先已经改变。这和 getChildIndices得到一个受影响的节点列表。

对此的一个例外是treenodeschanged事件，找出根源，在这种情况下，这会返回根和getChildIndices将返回null。

结果

用于识别改变节点的树路径。

另请参见：

TreePath.getLastPathComponent()

getPath

public Object[] getPath()

获取对象数组的实例，这一事件将树路径的便捷方法。

结果

一个对象的数组，其中第一个对象是存储在根中的一个对象，而最后一个对象是存储在路径确定的节点上的一个对象

getChildren

public Object[] getChildren()

返回的节点确定在指定的位置 getPath getChildIndices儿童对象。如果这是一个去除事件返回的对象不再是孩子的父节点。

结果

包含事件指定的子对象的数组

另请参见：

getPath()， getChildIndices()

getChildIndices

public int[] getChildIndices()

返回子索引的值。如果这是一个删除事件，则索引指向在删除项目的初始列表中的位置。如果它是一个插入物，则指数点到最后一个列表中的位置，其中的项目被添加。对于节点的变化，该指数点的修改后的节点的位置。

结果

包含由事件指定索引位置的孩子 int数组

toString

public String toString()

返回显示并标识该对象属性的字符串。

重写：

toString 方法重写，继承类 EventObject

结果

此对象的字符串表示形式