javax.swing.tree
클래스 TreePath

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

모든 구현된 인터페이스:

Serializable

public class TreePath
extends Object 
implements Serializable 

노드에의 패스를 나타냅니다. TreePath 와는 TreeModel 로부터 생성되는 Object 의 배열입니다. 배열의 요소는 항상 루트가 배열의 선두의 요소 (인덱스 0)가 되도록(듯이) 순서 붙이고 됩니다. TreePath 는 Serializable 입니다만, 패스의 컴퍼넌트가 직렬화 가능하지 않은 경우는, 써내지지 않습니다.

트리 패스의 상세 및 사용예는,「The Java Tutorial」의「How to Use Trees」섹션을 참조해 주세요.

경고: 이 클래스의 직렬화 된 객체는, 향후의 Swing 릴리스와 호환은 아니게 될 예정입니다. 현재의 직렬화의 지원는, 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. JDK Version 1.4 이후, 모든 JavaBeans^™ 의 장기간의 운용 지원는,java.beans 패키지에 추가되고 있습니다. 자세한 것은,XMLEncoder 를 참조해 주세요.

생성자 의 개요

protected	TreePath () 주로, 패스를 다양한 방법으로 나타내는 서브 클래스용으로 제공됩니다.
	TreePath (Object singlePath) 요소를 1개만 가지는 TreePath 를 구축합니다.
	TreePath (Object [] path) Object 의 배열로부터 패스를 구축해, 트리의 데이터 모델에 의해 반환되는, 트리의 루트로부터 특정의 노드까지의 패스를 일의에 식별합니다.
protected	TreePath (Object [] path, int length) 길이 length 의 식별 패스 컴포넌트가 있는 신규 TreePath 를 구축합니다.
protected	TreePath (TreePath parent, Object lastElement) 신규 TreePath 를 구축합니다.

메소드의 개요

boolean	equals (Object o) 각 패스의 요소가 같은가 어떤가를 판정해, 2개의 TreePath 가 같은가 어떤가를 판정합니다.
Object	getLastPathComponent () 이 패스의 말미 컴퍼넌트를 돌려줍니다.
TreePath	getParentPath () 객체의 모든 요소를 포함하는 패스를 돌려줍니다.
Object []	getPath () 이 TreePath 의 컴퍼넌트를 포함하는 Object 의 순서 첨부 배열을 돌려줍니다.
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)

Object 의 배열로부터 패스를 구축해, 트리의 데이터 모델에 의해 반환되는, 트리의 루트로부터 특정의 노드까지의 패스를 일의에 식별합니다.

모델은, 그것이 패스를 나타내는데 필요로 하는 임의의 Object 의 배열을 자유롭게 돌려줍니다. DefaultTreeModel 는 TreeNode 객체의 배열을 돌려줍니다. 패스의 최초의 TreeNode 는 트리의 루트로, 마지막 TreeNode 는 패스로 식별되는 노드입니다.

파라미터:

path - 노드에의 패스를 나타내는 Object 의 배열

TreePath

public TreePath(Object  singlePath)

요소를 1개만 가지는 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 메소드를 오버라이드(override) 할 필요가 있습니다.

메소드의 상세

getPath

public Object [] getPath()

이 TreePath 의 컴퍼넌트를 포함하는 Object 의 순서 첨부 배열을 돌려줍니다. 선두의 요소 (인덱스 0)는 루트입니다.

반환값:

TreePath 를 나타내는 Object 의 배열

관련 항목:

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)

각 패스의 요소가 같은가 어떤가를 판정해, 2개의 TreePath 가 같은가 어떤가를 판정합니다. 길이가 같아 같은 요소를 가지고 있는 경우 (. equals)는 2 살의 패스는 동등이라고 보여집니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

o - 비교 대상의 Object

반환값:

obj 인수로 지정된 객체와 이 객체가 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode() , Hashtable

hashCode

public int hashCode()

객체의 hashCode 를 돌려줍니다. TreePath 의 해시 코드는, 패스내에서 마지막 컴퍼넌트의 해시 코드가 되도록(듯이) 정의됩니다.

오버라이드(override):

클래스 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 를 throw 합니다.

getParentPath

public TreePath  getParentPath()

객체의 모든 요소를 포함하는 패스를 돌려줍니다. 다만, 마지막 패스 컴포넌트는 제외합니다.

toString

public String  toString()

이 객체의 프로퍼티을 표시 및 식별하는 캐릭터 라인을 돌려줍니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 객체의 캐릭터 라인 표현