javax.swing.tree
類別 TreePath

java.lang.Object
  javax.swing.tree.TreePath

所有已實作的介面：

Serializable

public class TreePath
extends Object
implements Serializable

表示節點的路徑。TreePath 是 TreeModel 提供的 Objects 的陣列。對陣列的元素進行排序，使根始終是陣列的第一個元素 (index 為 0)。TreePath 是可序列化的，但是如果該路徑的任何元件不可序列化，則它將不能寫出。

有關使用階層樹路徑的更多資訊和範例，請參閱 The Java Tutorial 中的 How to Use Trees 一節。

警告：此類別的已序列化物件與以後的 Swing 版本不相容。當前的序列化支持適用於短期存儲或運行相同 Swing 版本的應用程序之間的 RMI。從 1.4 版本開始，已在 java.beans 套件中添加了支持所有 JavaBeans^TM 長期存儲的功能。請參見 XMLEncoder。

建構子摘要

protected	TreePath() 主要為以不同方式表示路徑的子類別提供。
	TreePath(Object singlePath) 建構僅包含單個元素的 TreePath。
	TreePath(Object[] path) 根據 Objects 的陣列建構路徑，並根據階層樹的資料模型的返回情況，唯一地標識階層樹的根到指定節點的路徑。
protected	TreePath(Object[] path, int length) 建構一個具有長度為 length 的標識路徑元件的新 TreePath。
protected	TreePath(TreePath parent, Object lastElement) 建構一個新的 TreePath，它是以 lastElement 結束的 parent 標識的路徑。

方法摘要

boolean	equals(Object o) 通過檢查路徑中每個元素的相等性，測試兩個 TreePaths 的相等性。
Object	getLastPathComponent() 返回此路徑的最後一個元件。
TreePath	getParentPath() 返回包含除最後一個路徑元件之外的此物件所有元素的路徑。
Object[]	getPath() 返回有序的 Objects 陣列，它包含此 TreePath 的元件。
Object	getPathComponent(int element) 返回指定索引位置的路徑元件。
int	getPathCount() 返回路徑中的元素數。
int	hashCode() 返回該物件的 hashCode。
boolean	isDescendant(TreePath aTreePath) 如果 aTreePath 為此 TreePath 的後代，則返回 true。
TreePath	pathByAddingChild(Object child) 返回包含此物件的所有元素加上 child 的新路徑。
String	toString() 返回一個顯示並標識此物件屬性的字元串。

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

TreePath

public TreePath(Object[] path)

根據 Objects 的陣列建構路徑，並根據階層樹的資料模型的返回情況，唯一地標識階層樹的根到指定節點的路徑。

該模型可自由地返回需要表示該路徑的任何 Objects 的陣列。DefaultTreeModel 返回 TreeNode 物件的陣列。該路徑中的第一個 TreeNode 是階層樹的根，最後一個 TreeNode 是該路徑標識的節點。

參數：

path - 表示節點路徑的 Objects 陣列

TreePath

public TreePath(Object singlePath)

建構僅包含單個元素的 TreePath。這通常用於建構 TreeModel 的根的 TreePath。

參數：

singlePath - 表示節點路徑的 Object

另請參見：

TreePath(Object[])

TreePath

protected TreePath(TreePath parent,
                   Object lastElement)

建構一個新的 TreePath，它是以 lastElement 結束的 parent 標識的路徑。

TreePath

protected TreePath(Object[] path,
                   int length)

建構一個具有長度為 length 的標識路徑元件的新 TreePath。

TreePath

protected TreePath()

主要為以不同方式表示路徑的子類別提供。如果子類別使用此建構子，則它還應覆寫 getPath、getPathCount 和 getPathComponent 方法，並可能覆寫 equals 方法。

方法詳細資訊

getPath

public Object[] getPath()

返回有序的 Objects 陣列，它包含此 TreePath 的元件。第一個元素 (index 為 0) 是根。

返回：

表示 TreePath 的 Objects 的陣列

另請參見：

TreePath(Object[])

getLastPathComponent

public Object getLastPathComponent()

返回此路徑的最後一個元件。對於 DefaultTreeModel 返回的路徑，它將返回一個 TreeNode 實例。

返回：

該路徑結尾處的 Object

另請參見：

TreePath(Object[])

getPathCount

public int getPathCount()

返回路徑中的元素數。

返回：

給出路徑項計數的 int

getPathComponent

public Object getPathComponent(int element)

返回指定索引位置的路徑元件。

參數：

element - 指定路徑中元素的 int，其中 0 表示路徑中的第一個元素

返回：

該索引位置的 Object

拋出：

IllegalArgumentException - 如果索引超過路徑的長度

另請參見：

TreePath(Object[])

equals

public boolean equals(Object o)

通過檢查路徑中每個元素的相等性，測試兩個 TreePaths 的相等性。如果兩個路徑等長，並且包含相同的元素 (.equals)，則認為它們相等。

覆寫：

類別 Object 中的 equals

參數：

o - 要比較的 Object

返回：

如果此物件與 obj 參數相同，則返回 true；否則返回 false。

另請參見：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

返回該物件的 hashCode。TreePath 的雜湊程式碼被定義為路徑中最後一個元件的雜湊程式碼。

覆寫：

類別 Object 中的 hashCode

返回：

此物件的 hashCode

另請參見：

Object.equals(java.lang.Object), Hashtable

isDescendant

public boolean isDescendant(TreePath aTreePath)

如果 aTreePath 為此 TreePath 的後代，則返回 true。如果 P1 套件含組成 P2 路徑的所有元件，則 TreePath P1 是 TreePath P2 的後代。例如，如果此物件具有路徑 [a, b]，並且 aTreePath 具有路徑 [a, b, c]，那麼 aTreePath 為此物件的後代。但是，如果 aTreePath 具有路徑 [a]，那麼它不是此物件的後代。按照此定義，TreePath 始終被視為其自身的後代。也就是說，aTreePath.isDescendant(aTreePath) 返回 true。

返回：

如果 aTreePath 為此路徑的後代，則返回 true

pathByAddingChild

public TreePath pathByAddingChild(Object child)

返回包含此物件的所有元素加上 child 的新路徑。child 將是新創建的 TreePath 的最後一個元素。如果子物件為 null，將拋出 NullPointerException。

getParentPath

public TreePath getParentPath()

返回包含除最後一個路徑元件之外的此物件所有元素的路徑。

toString

public String toString()

返回一個顯示並標識此物件屬性的字元串。

覆寫：

類別 Object 中的 toString

返回：

此物件的 String 表示形式