JavaTM Platform
Standard Ed. 6

javax.swing.event
接口 TreeModelListener

所有超级接口:
EventListener
所有已知实现类:
BasicTreeUI.TreeModelHandler, JTree.AccessibleJTree, JTree.TreeModelHandler

public interface TreeModelListener
     
extends EventListener

定义侦听 TreeModel 中更改的对象的接口。有关更多信息和示例,请参阅 The Java Tutorial 中的How to Write a Tree Model Listener 一节。


方法摘要
 void treeNodesChanged(TreeModelEvent e)
          在已经以某种方式更改节点(或同级节点集)后调用。
 void treeNodesInserted(TreeModelEvent e)
          在已将节点插入树中以后调用。
 void treeNodesRemoved(TreeModelEvent e)
          在已从树中移除节点后调用。
 void treeStructureChanged(TreeModelEvent e)
          在树结构中从某个给定节点开始向下的地方发生彻底更改之后调用。
 

方法详细信息

treeNodesChanged

void treeNodesChanged(TreeModelEvent e)

在已经以某种方式更改节点(或同级节点集)后调用。这些节点在树中的位置没有改变,或者说没有更改其子数组,但其他一些属性已发生更改,并且可能影响表示形式。示例:文件的名称已更改,但它仍然在文件系统中的同一位置上。

要指示根已更改,则 childIndices 和 children 将为 null。

可使用 e.getPath() 获得已更改节点的父节点。e.getChildIndices() 返回已更改节点的索引。


treeNodesInserted

void treeNodesInserted(TreeModelEvent e)

在已将节点插入树中以后调用。

可使用 e.getPath() 获得新节点的父节点。e.getChildIndices() 按升序返回新节点的索引。


treeNodesRemoved

void treeNodesRemoved(TreeModelEvent e)

在已从树中移除节点后调用。注意,如果从树中移除一个子树,则可能仅对已移除子树的根调用此方法一次,而不是对每个已移除的同级子树集调用一次。

可使用 e.getPath() 获得已删除节点的前父节点。e.getChildIndices() 按升序返回删除此节点前该节点所拥有的索引。


treeStructureChanged

void treeStructureChanged(TreeModelEvent e)

在树结构中从某个给定节点开始向下的地方发生彻底更改之后调用。如果由 e.getPath() 返回的路径长度为 1,并且第一个元素并没有标识当前根节点,则第一个元素应该成为树的新根。

可使用 e.getPath() 获得到该节点的路径。e.getChildIndices() 返回 null。


JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策