org.zkoss.zul
Interface TreeModel<E>

All Known Implementing Classes:

AbstractTreeModel, DefaultTreeModel

public interface TreeModel<E>

This interface defines the methods that component like Tree use to get the content of items.

Note: changing a render will not cause the tree to re-render. If you want it to re-render, you could assign the same model again (i.e., setModel(getModel())), or fire an TreeDataEvent event.

For introduction, please refer to ZK Developer's Reference: Tree Model.

Since:

3.0.0

Author:

Jeff Liu, tomyeh

Method Summary

void	addTreeDataListener(TreeDataListener l) Add a listener to the tree that's notified each time a change to the data model occurs
E	getChild(E parent, int index) Returns the child of the given parent at the given index where the index indicates in the parent's child array.
E	getChild(int[] path) Returns the child at the given path where the path indicates the child is placed in the whole tree.
int	getChildCount(E parent) Returns the number of children of the given parent.
int	getIndexOfChild(E parent, E child) Returns the index of the given child in the given parent.
int[]	getPath(E child) Returns the path from the given child, where the path indicates the child is placed in the whole tree.
E	getRoot() Returns the root of the tree.
boolean	isLeaf(E node) Returns true if node is a leaf.
void	removeTreeDataListener(TreeDataListener l) Remove a listener to the tree that's notified each time a change to the data model occurs

Method Detail

isLeaf

boolean isLeaf(E node)

Returns true if node is a leaf. Notice that not all non-leaf nodes have children. In file-system terminology, a leaf node is a file, while a non-leaf node is a folder.

Parameters:

node - a node in the tree, obtained from this data source

Returns:

true if node is a leaf.

getChild

E getChild(E parent,
           int index)

Returns the child of the given parent at the given index where the index indicates in the parent's child array.

Parameters:

parent - a node in the tree, obtained from this data source

Returns:

the child of parent at index

getChildCount

int getChildCount(E parent)

Returns the number of children of the given parent.

Parameters:

parent - a node in the tree, obtained from this data source

Returns:

the number of children of the node parent

getIndexOfChild

int getIndexOfChild(E parent,
                    E child)

Returns the index of the given child in the given parent. If either parent or child is null, returns -1. If either parent or child don't belong to this tree model, returns -1.

Parameters:

parent - a node in the tree, obtained from this data source

child - the node we are interested in

Returns:

the index of the child in the parent, or -1 if either child or parent are null or don't belong to this tree model

Since:

5.0.6

getRoot

E getRoot()

Returns the root of the tree.

Returns:

the root of Tree.

getChild

E getChild(int[] path)

Returns the child at the given path where the path indicates the child is placed in the whole tree.

Parameters:

path - the tree path

Returns:

the child at path

Since:

6.0.0

getPath

int[] getPath(E child)

Returns the path from the given child, where the path indicates the child is placed in the whole tree.

Parameters:

child - the node we are interested in

Since:

6.0.0

addTreeDataListener

void addTreeDataListener(TreeDataListener l)

Add a listener to the tree that's notified each time a change to the data model occurs

Parameters:

l - the listener to add

removeTreeDataListener

void removeTreeDataListener(TreeDataListener l)

Remove a listener to the tree that's notified each time a change to the data model occurs

Parameters:

l - the listener to remove