站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

TreeModel (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助 
JavaTM 2 Platform
Standard Ed. 5.0
 上一个类   下一个类 框架    无框架    
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法

javax.swing.tree
接口 TreeModel

所有已知实现类：
DefaultTreeModel
public interface TreeModel

为 JTree 定义合适的数据模型的界面。有关树模型的更多信息（包括自定义实现的示例），请参阅《The Java Tutorial》中的 How to Use Trees 一节。

JTree 及其相关的类大量使用了 TreePath，以标识 TreeModel 中的节点。如果 TreeModel 返回相同的对象（使用 equals 比较同一父节点下的两个不同索引的节点），那么产生的 TreePath 对象也被认为是相等的。某些实现可以假定，如果两个 TreePath 相等，则它们标识的节点也相等。如果不能满足此条件，则可能导致绘制问题和其他奇怪的问题。换句话说，如果对给定父节点调用 getChild 返回相同的 Object（由 equals 确定），则可能出现问题，建议您不要执行此操作。

另请参见：
TreePath

方法摘要
 void addTreeModelListener(TreeModelListener l)
          为树更改后发布的 TreeModelEvent 添加侦听器。
 Object getChild(Object parent, int index)
          返回父节点的子数组中索引 index 位置的 parent 的子节点。
 int getChildCount(Object parent)
          返回 parent 的子节点数。
 int getIndexOfChild(Object parent, Object child)
          返回父节点中子节点的索引。
 Object getRoot()
          返回树的根。
 boolean isLeaf(Object node)
          如果 node 为叶节点，则返回 true。
 void removeTreeModelListener(TreeModelListener l)
          移除以前通过 addTreeModelListener 添加的侦听器。
 void valueForPathChanged(TreePath path, Object newValue)
          用户已将 path 标识的项的值更改为 newValue 时，进行通知。
 

方法详细信息

getRoot

Object getRoot()
返回树的根。仅当树没有节点时，才返回 null。

返回：
树的根

getChild

Object getChild(Object parent,
                int index)
返回父节点的子数组中索引 index 位置的 parent 的子节点。parent 必须是以前从此数据源获取的节点。如果 index 是 parent 的一个有效索引（即：index >= 0 && index < getChildCount(parent)），则此方法不应返回 null。

参数：
parent - 从此数据源获取的树中的节点
返回：
索引 index 位置的 parent 的子节点

getChildCount

int getChildCount(Object parent)
返回 parent 的子节点数。如果该节点为叶节点，或者它没有子节点，则返回 0。parent 必须是以前从此数据源获取的节点。

参数：
parent - 从此数据源获取的树中的节点
返回：
节点 parent 的子节点数

isLeaf

boolean isLeaf(Object node)
如果 node 为叶节点，则返回 true。即使 node 没有子节点，此方法也可能返回 false。例如，文件系统中的目录可以不包含任何文件；表示该目录的节点不是叶节点，但是它也没有任何子节点。

参数：
node - 从此数据源获取的树中的节点
返回：
如果 node 为叶节点，则返回 true

valueForPathChanged

void valueForPathChanged(TreePath path,
                         Object newValue)
用户已将 path 标识的项的值更改为 newValue 时，进行通知。如果 newValue 表示一个真实的新值，则该模型应发布一个 treeNodesChanged 事件。

参数：
path - 用户已更改的节点的路径
newValue - TreeCellEditor 的新值

getIndexOfChild

int getIndexOfChild(Object parent,
                    Object child)
返回父节点中子节点的索引。如果 parent 或 child 为 null，则返回 -1。如果 parent 或 child 不属于此树模型，则返回 -1。

参数：
parent - 从此数据源获取的树中的节点
child - 相关的节点
返回：
父节点中子节点的索引，如果 child 或 parent 为 null，或不属于此树模型，则返回 -1

addTreeModelListener

void addTreeModelListener(TreeModelListener l)
为树更改后发布的 TreeModelEvent 添加侦听器。

参数：
l - 要添加的侦听器
另请参见：
removeTreeModelListener(javax.swing.event.TreeModelListener)

removeTreeModelListener

void removeTreeModelListener(TreeModelListener l)
移除以前通过 addTreeModelListener 添加的侦听器。

参数：
l - 要移除的侦听器
另请参见：
addTreeModelListener(javax.swing.event.TreeModelListener)
概述  软件包   类  使用  树  已过时  索引  帮助 
JavaTM 2 Platform
Standard Ed. 5.0
 上一个类   下一个类 框架    无框架    
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

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