javax.swing.tree
인터페이스 TreeModel

알려진 구현 클래스 목록:

DefaultTreeModel

public interface TreeModel

JTree에 최적인 데이터 모델을 정의하는 인터페이스입니다. 커스텀 구현의 예를 포함한 트리 모델의 상세한 것에 대하여는 「The Java Tutorial」의 「How to Use Trees」를 참조하십시오.

JTree와 그 관련 클래스는 TreeModel 내의 노드를 식별하기 위해서 TreePath를 광범위하게 걸쳐 사용합니다. TreeModel로 같은 부모아래의 2개가 다른 인덱스에 있는 같은 객체 (equals로 비교된 것)가 돌려주고지면, 생성된 TreePath 객체도 이와 같이 동일하다고 보여집니다. 일부의 구현에서는 2개의 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) newValue에 의 path에 의해 식별되는 항목의 값을 사용자가 변경하면, 메세지로 송신됩니다.

메서드의 상세

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)

newValue에 의 path에 의해 식별되는 항목의 값을 사용자가 변경하면, 메세지로 송신됩니다. newValue가 정말로 새로운 값을의미하는 경우에는 모델은 treeNodesChanged 이벤트를 송신하지 않으면 안됩니다.

파라미터:

path - 사용자가 변경한 노드에의 패스

newValue - TreeCellEditor 로부터의 새로운 값

getIndexOfChild

int getIndexOfChild(Object  parent,
                    Object  child)

부모에 있어서의자식 의 인덱스를 리턴합니다. parent 또는 child 어느 쪽인지가 null인 경우는 -1을 리턴합니다. parent 또는 child 어느 쪽인지가 이 트리 모델에 속하지 않은 경우도,-1를 리턴합니다.

파라미터:

parent - 이 데이터 소스로부터 취득된, 트리내의 노드

child - 대상이 되는 노드

반환값:

부모에 있어서의자식 의 인덱스. parent 또는 child 어느 쪽인지가 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)