javax.swing.tree

Class TreePath

java.lang.Object

javax.swing.tree.TreePath

All Implemented Interfaces:

Serializable

public class TreePath
extends Object
implements Serializable

TreePath代表对象的唯一标识路径树中的节点数组。数组的元素被排列为数组的第一个元素的根。例如，基于父目录数组和文件名的基础上唯一标识的文件系统上的文件是唯一标识的。路径 /tmp/foo/bar可以通过 TreePath表示为 new TreePath(new Object[] {"tmp", "foo", "bar"})。

TreePath由JTree广泛应用和相关的类。例如，JTree代表的选择作为TreePaths数组。当使用JTree，路径的元素是对象从TreeModel返回。当JTree搭配DefaultTreeModel，路径的元素TreeNodes。下面的例子说明了如何从一个JTree选择提取用户对象：

defaultmutabletreenode根=…；defaulttreemodel模式=新的defaulttreemodel（根）；JTree树=新的树形结构（模型）；…TreePath selectedPath =树。getselectionpath()；DefaultMutableTreeNode selectedNode =（（defaultmutabletreenode）selectedpath。getlastpathcomponent()）。getuserobject()；

子类通常需要重写只有 getLastPathComponent，和 getParentPath。作为 JTree内部创建了在各点 TreePaths，这通常不是继承 TreePath使用 JTree有用。

而TreePath是可序列化的，一NotSerializableException如果路径的任意元素是不可序列化的扔。

用树路径的进一步信息和例子，看到在java教程How to Use Trees。

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

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	TreePath() 创建一个空的 TreePath。
	TreePath(Object lastPathComponent) 创建一个 TreePath包含一个单独的元件。
	TreePath(Object[] path) 创建数组 TreePath。
protected	TreePath(Object[] path, int length) 创建数组 TreePath。
protected	TreePath(TreePath parent, Object lastPathComponent) 创建一个具有指定父元素 TreePath。

方法摘要

Modifier and Type	Method and Description
boolean	equals(Object o) 比较这 TreePath到指定的对象。
Object	getLastPathComponent() 返回此路径的最后一个元素。
TreePath	getParentPath() 返回父级的 TreePath。
Object[]	getPath() 返回该 TreePath元素的有序排列。
Object	getPathComponent(int index) 返回指定索引处的路径元素。
int	getPathCount() 返回路径中元素的数目。
int	hashCode() 返回该 TreePath哈希代码。
boolean	isDescendant(TreePath aTreePath) 如果 aTreePath是这一 TreePath后裔返回true。
TreePath	pathByAddingChild(Object child) 返回一个新的路径包含所有这些路径加 child元素。
String	toString() 返回显示并标识该对象属性的字符串。

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

TreePath

@ConstructorProperties(value="path")
public TreePath(Object[] path)

创建数组 TreePath。该数组唯一标识一个节点的路径。

参数

path -代表路径的节点对象的数组

异常

IllegalArgumentException -如果 path是 null，空的，或包含一个 null价值

TreePath

public TreePath(Object lastPathComponent)

创建一个 TreePath包含一个单独的元件。这是用来构建一个 TreePath标识根。

参数

lastPathComponent -根

异常

如果是 null lastPathComponent IllegalArgumentException

另请参见：

TreePath(Object[])

TreePath

protected TreePath(TreePath parent,
                   Object lastPathComponent)

创建一个具有指定父元素 TreePath。

参数

parent -路径的父，或 null表示根

lastPathComponent -最后的路径元素

异常

如果是 null lastPathComponent IllegalArgumentException

TreePath

protected TreePath(Object[] path,
                   int length)

创建数组 TreePath。返回的 TreePath表示从 length - 1 0到数组的元素。

此构造函数内部使用，一般不在子类外部使用。

参数

path -数组创建 TreePath从

length标识元素在 path数量创造 TreePath从

异常

如果是 null path NullPointerException

ArrayIndexOutOfBoundsException -如果 length - 1超出数组范围

IllegalArgumentException -如果任何元素从 0到 length - 1是 null

TreePath

protected TreePath()

创建一个空的 TreePath。这是提供的子类，以不同的方式表示路径。使用此构造函数子类必须重写 getLastPathComponent，和 getParentPath。

方法详细信息

getPath

public Object[] getPath()

返回该 TreePath元素的有序排列。第一个元素是根。

结果

在这 TreePath的元素的数组

getLastPathComponent

public Object getLastPathComponent()

返回此路径的最后一个元素。

结果

路径中的最后一个元素

getPathCount

public int getPathCount()

返回路径中元素的数目。

结果

路径中的元素数

getPathComponent

public Object getPathComponent(int index)

返回指定索引处的路径元素。

参数

index -元素的指标要求

结果

指定索引中的元素

异常

IllegalArgumentException -如果指数在这条路的范围

equals

public boolean equals(Object o)

比较这 TreePath到指定的对象。这还 true如果 o是具有完全相同的元素 TreePath（利用 equals路径上各元素的测定）。

重写：

equals 方法重写，继承类 Object

参数

o -比较对象

结果

如果这个对象是 true obj参数相同； false否则。

另请参见：

Object.hashCode()， HashMap

hashCode

public int hashCode()

返回该 TreePath哈希代码。一个 TreePath哈希代码路径中的最后一个元素的哈希码。

重写：

hashCode 方法重写，继承类 Object

结果

该对象的hashCode

另请参见：

Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)

isDescendant

public boolean isDescendant(TreePath aTreePath)

如果 aTreePath是这一 TreePath后裔返回true， TreePath P1是一个 TreePath P2后代如果 P1包含所有构成元素 P2's路径。例如，如果该对象的路径 [a, b]，和 aTreePath具有路径 [a, b, c]，然后 aTreePath是这一对象的后代。然而，如果 aTreePath具有路径 [a]，那它就不是一个该对象的后裔。按照这一定义， TreePath总是认为本身的后裔。那是， aTreePath.isDescendant(aTreePath)返回 true。

参数

aTreePath - TreePath检查

结果

如果 aTreePath是这一路径的后裔

pathByAddingChild

public TreePath pathByAddingChild(Object child)

返回一个新的路径包含所有这些路径加 child元素。 child是新创建的最后一个元素 TreePath。

参数

child -路径元素添加

异常

如果是 null child NullPointerException

getParentPath

public TreePath getParentPath()

返回父级的 TreePath。一个 null返回值表示这是根节点。

结果

父路径

toString

public String toString()

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

重写：

toString 方法重写，继承类 Object

结果

此对象的字符串表示形式