Tree (ZK XUL Components 8.0.0 API)

java.lang.Object
- org.zkoss.zk.ui.AbstractComponent
- - org.zkoss.zk.ui.HtmlBasedComponent
  - - org.zkoss.zul.impl.XulElement
    - - org.zkoss.zul.impl.MeshElement
      - org.zkoss.zul.Tree

All Implemented Interfaces:

Serializable, Cloneable, org.zkoss.zk.ui.Component, org.zkoss.zk.ui.ext.Scope, org.zkoss.zk.ui.sys.ComponentCtrl, Paginated
```
public class Tree
extends MeshElement
```
A container which can be used to hold a tabular or hierarchical set of rows of elements.
Event:
1. SelectEvent is sent when user changes the selection.
2. onAfterRender is sent when the model's data has been rendered.(since 5.0.4)
Default getZclass(): z-tree. (since 3.5.0)
Custom Attributes:
org.zkoss.zul.tree.rightSelect

Specifies whether the selection shall be toggled when user right clicks on item, if the checkmark (isCheckmark()) is enabled.
Notice that you could specify this attribute in any of its ancestor's attributes. It will be inherited.

org.zkoss.zul.tree.autoSort
.(since 5.0.7)
Specifies whether to sort the model when the following cases:
1. setModel(org.zkoss.zul.TreeModel<?>) is called and Treecol.setSortDirection(java.lang.String) is set.
2. Treecol.setSortDirection(java.lang.String) is called.
3. Model receives TreeDataEvent and Treecol.setSortDirection(java.lang.String) is set.
If you want to ignore sort when receiving TreeDataEvent, you can specifies the value as "ignore.change".
Notice that you could specify this attribute in any of its ancestor's attributes. It will be inherited.
[Since 6.0.0]
To retrieve what are selected in Tree with a TreeSelectableModel, you shall use TreeSelectableModel.isPathSelected(int[]) to check whether the current path is selected in TreeSelectableModel rather than using getSelectedItems(). That is, you shall operate on the item of the TreeSelectableModel rather than on the Treeitem of the Tree if you use the TreeSelectableModel and TreeModel.
```
 TreeSelectableModel selModel = ((TreeSelectableModel)getModel());
 int[][] paths = selModel.getSelectionPaths();
 List selected = new ArrayList();
 AbstractTreeModel model = (AbstractTreeModel) selModel;
 for (int i = 0; i < paths.length; i++) {
                selected.add(model.getChild(paths[i]));
 }
 
```
[Since 6.0.0]
If the TreeModel in Tree implements a TreeSelectableModel, the multiple selections status is applied from the method of TreeSelectableModel.isMultiple()
```
 DefaultTreeModel selModel = new DefaultTreeModel(treeNode);
 selModel.setMultiple(true);
 tree.setModel(selModel);
 
```
[Since 6.0.0]
To retrieve what are opened nodes in Tree with a TreeOpenableModel, you shall use TreeOpenableModel.isPathOpened(int[]) to check whether the current path is opened in TreeOpenableModel rather than using Treeitem.isOpen(). That is, you shall operate on the item of the TreeOpenableModel rather than on the Treeitem of the Tree if you use the TreeOpenableModel and TreeModel.
```
 TreeOpenableModel openModel = ((TreeOpenableModel)getModel());
 int[][] paths = openModel.getOpenPaths();
 List opened = new ArrayList();
 AbstractTreeModel model = (AbstractTreeModel) openModel;
 for (int i = 0; i < paths.length; i++) {
                opened.add(model.getChild(paths[i]));
 }
 
```
org.zkoss.zul.tree.selectOnHighlight.disabled
.(since 7.0.4)
Sets whether to disable select functionality when highlighting text content with mouse dragging or not.

[Since 7.0.0] (EE version only)
org.zkoss.zul.tree.initRodSize
.
Specifies the number of items rendered when the Tree first render.
org.zkoss.zul.tree.maxRodPageSize
.
Specifies how many pages (of treeitems) to keep rendered in memory (on the server side) when navigating the tree using pagination. (Paging mold only)
org.zkoss.zul.tree.preloadSize
.
Specifies the number of items to preload when receiving the rendering request from the client.
It is used only if live data (setModel(TreeModel) and not paging (getPagingChild()).
Author:

tomyeh

See Also:
Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from class org.zkoss.zul.impl.MeshElement
  MeshElement.InternalPaging
- Nested classes/interfaces inherited from class org.zkoss.zk.ui.HtmlBasedComponent
  org.zkoss.zk.ui.HtmlBasedComponent.ExtraCtrl
- Nested classes/interfaces inherited from class org.zkoss.zk.ui.AbstractComponent
  org.zkoss.zk.ui.AbstractComponent.Children

Field Summary
- Fields inherited from class org.zkoss.zk.ui.HtmlBasedComponent
  _zclass
- Fields inherited from interface org.zkoss.zk.ui.Component
  APPLICATION_SCOPE, COMPONENT_SCOPE, DESKTOP_SCOPE, PAGE_SCOPE, REQUEST_SCOPE, SESSION_SCOPE, SPACE_SCOPE
- Fields inherited from interface org.zkoss.zk.ui.sys.ComponentCtrl
  CE_BUSY_IGNORE, CE_DUPLICATE_IGNORE, CE_IMPORTANT, CE_NON_DEFERRABLE, CE_REPEAT_IGNORE

Constructor Summary

Constructors
Constructor and Description

Tree()

Constructors
Constructor and Description
`Tree()`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addItemToSelection(Treeitem item)` Selects the given item, without deselecting any other items that are already selected..
`void`	`beforeChildAdded(org.zkoss.zk.ui.Component newChild, org.zkoss.zk.ui.Component refChild)`
`void`	`clear()` Clears all child tree items (`Treeitem`.
`void`	`clearSelection()` Clears the selection.
`Object`	`clone()`
`int`	`getActivePage()` Returns the active page (starting from 0).
`protected Object`	`getAssociatedNode(Treeitem ti, Tree t)` Return a node which is an associated Treeitem ti in a Tree tree
`protected org.zkoss.zk.ui.Component`	`getChildByNode(Object node)` Return the Tree or Treeitem component by a given associated node in model, or null if the treeitem is not instantiated (i.e., rendered) yet.
`protected org.zkoss.zk.ui.Component`	`getChildByPath(int[] path)` Return the Tree or Treeitem component by a path, or null if corresponding Treeitem is not instantiated (i.e., rendered) yet.
`Frozen`	`getFrozen()` Returns the frozen child.
`Collection<org.zkoss.zk.ui.Component>`	`getHeads()` Returns a collection of heads, including `getTreecols()` and auxiliary heads (`Auxhead`) (never null).
`String`	`getInnerWidth()` Returns the inner width of this component.
`int`	`getItemCount()` Returns the number of child `Treeitem`.
`<T> TreeitemRenderer<T>`	`getItemRenderer()` Returns the renderer to render each item, or null if the default renderer is used.
`Collection<Treeitem>`	`getItems()` Returns a readonly list of all descending `Treeitem` (children's children and so on).
`<T> TreeModel<T>`	`getModel()` Returns the list model associated with this tree, or null if this tree is not associated with any tree data model.
`String`	`getName()` Returns the name of this component.
`String`	`getNonselectableTags()` Returns a list of HTML tag names that shall not cause the tree item being selected if they are clicked.
`int`	`getPageSize()` Returns the page size, a.k.a., the number items per page.
`Paginal`	`getPaginal()` Returns the paging controller, or null if not available.
`Paging`	`getPagingChild()` Returns the child paging controller that is created automatically, or null if mold is not "paging", or the controller is specified externally by `setPaginal(org.zkoss.zul.ext.Paginal)`.
`int`	`getRows()` Returns the rows.
`int`	`getSelectedCount()` Returns the number of items being selected.
`Treeitem`	`getSelectedItem()` Returns the selected item.
`Set<Treeitem>`	`getSelectedItems()` Returns all selected items.
`String`	`getSeltype()` Returns the seltype.
`int`	`getTabindex()` Returns the tab order of this component.
`Treechildren`	`getTreechildren()` Returns the treechildren that this tree owns (might null).
`Treecols`	`getTreecols()` Returns the treecols that this tree owns (might null).
`Treefoot`	`getTreefoot()` Returns the treefoot that this tree owns (might null).
`<T> TreeitemRenderer<T>`	`getTreeitemRenderer()` Deprecated. As of release 5.0.6, replaced with `getItemRenderer()`. /* Returns the renderer to render each item, or null if the default renderer is used.*
`String`	`getZclass()`
`boolean`	`insertBefore(org.zkoss.zk.ui.Component newChild, org.zkoss.zk.ui.Component refChild)`
`protected boolean`	`isAutohidePaging()`
`boolean`	`isCheckmark()` Returns whether the check mark shall be displayed in front of each item.
`boolean`	`isFixedLayout()` Deprecated. since 5.0.0, use !`MeshElement.isSizedByContent()` instead
`boolean`	`isMultiple()` Returns whether multiple selections are allowed.
`protected boolean`	`isSelectOnHighlightDisabled()`
`boolean`	`isVflex()` Returns whether to grow and shrink vertical to fit their given space, so called vertical flexibility.
`void`	`onAfterRender()`
`void`	`onChildAdded(org.zkoss.zk.ui.Component child)`
`void`	`onChildRemoved(org.zkoss.zk.ui.Component child)`
`void`	`onInitRender()` Handles a private event, onInitRender.
`void`	`onPageAttached(org.zkoss.zk.ui.Page newpage, org.zkoss.zk.ui.Page oldpage)`
`void`	`onPageDetached(org.zkoss.zk.ui.Page page)`
`protected Paginal`	`pgi()` Returns the instance of the @{link Paginal}
`protected void`	`redrawChildren(Writer out)`
`void`	`removeItemFromSelection(Treeitem item)` Deselects the given item without deselecting other items.
`void`	`renderItem(Treeitem item)` Renders the specified `Treeitem`, if not loaded yet, with `getItemRenderer()`.
`void`	`renderItem(Treeitem item, Object node)` Renders the specified `Treeitem`, if not loaded yet, with `getItemRenderer()`.
`Treeitem`	`renderItemByNode(Object node)` Load the treeitems by the given node.
`Treeitem`	`renderItemByPath(int[] path)` Load the treeitems by giving a path of the treeitems top open.
`void`	`renderItems(Set<? extends Treeitem> items)` Renders the specified `Treeitem` if not loaded yet, with `getItemRenderer()`.
`protected void`	`renderProperties(org.zkoss.zk.ui.sys.ContentRenderer renderer)`
`void`	`selectAll()` Selects all items.
`void`	`selectItem(Treeitem item)` Deselects all of the currently selected items and selects the given item.
`void`	`service(org.zkoss.zk.au.AuRequest request, boolean everError)` Processes an AU request.
`void`	`sessionDidActivate(org.zkoss.zk.ui.Page page)`
`void`	`sessionWillPassivate(org.zkoss.zk.ui.Page page)`
`void`	`setActivePage(int pg)` Sets the active page (starting from 0).
`void`	`setActivePage(Treeitem item)` Sets the active page in which the specified item is.
`void`	`setCheckmark(boolean checkmark)` Sets whether the check mark shall be displayed in front of each item.
`void`	`setFixedLayout(boolean fixedLayout)` Deprecated. since 5.0.0, use `MeshElement.setSizedByContent(boolean)`(!fixedLayout) instead
`void`	`setInnerWidth(String innerWidth)` Sets the inner width of this component.
`void`	`setItemRenderer(String clsnm)` Sets the renderer by use of a class name.
`void`	`setItemRenderer(TreeitemRenderer<?> renderer)` Sets the renderer which is used to render each item if `getModel()` is not null.
`void`	`setModel(TreeModel<?> model)` Sets the tree model associated with this tree.
`void`	`setMold(String mold)` Sets the mold to render this component.
`void`	`setMultiple(boolean multiple)` Sets whether multiple selections are allowed.
`void`	`setName(String name)` Sets the name of this component.
`void`	`setNonselectableTags(String tags)` Sets a list of HTML tag names that shall not cause the tree item being selected if they are clicked.
`void`	`setPageSize(int pgsz)` Sets the page size, a.k.a., the number items per page.
`void`	`setPaginal(Paginal pgi)`
`void`	`setRows(int rows)` Sets the rows.
`void`	`setSelectedItem(Treeitem item)` Deselects all of the currently selected items and selects the given item.
`void`	`setSeltype(String seltype)` Sets the seltype.
`void`	`setTabindex(int tabindex)` Sets the tab order of this component.
`void`	`setTreeitemRenderer(TreeitemRenderer<?> renderer)` Deprecated. As of release 5.0.6, replaced with `setItemRenderer(org.zkoss.zul.TreeitemRenderer<?>)`. Sets the renderer which is used to render each item if `getModel()` is not null. 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.
`void`	`setVflex(boolean vflex)` Sets whether to grow and shrink vertical to fit their given space, so called vertical flexibility.
`void`	`smartUpdate(String attr, Object value)`
`void`	`toggleItemSelection(Treeitem item)` If the specified item is selected, it is deselected.

Methods inherited from class org.zkoss.zul.impl.MeshElement
getPageCount, getPagingPosition, getSpan, isAutopaging, isSizedByContent, isSpan, setAutopaging, setPagingPosition, setSizedByContent, setSpan, setSpan

Methods inherited from class org.zkoss.zul.impl.XulElement
getContext, getCtrlKeys, getPopup, getPropertyAccess, getTooltip, setContext, setContext, setCtrlKeys, setPopup, setPopup, setTooltip, setTooltip

Methods inherited from class org.zkoss.zk.ui.HtmlBasedComponent
focus, getAction, getDraggable, getDroppable, getExtraCtrl, getHeight, getHflex, getLeft, getRenderdefer, getSclass, getStyle, getTooltiptext, getTop, getVflex, getWidth, getZindex, getZIndex, setAction, setClass, setDraggable, setDroppable, setFocus, setHeight, setHeightDirectly, setHflex, setHflexDirectly, setLeft, setLeftDirectly, setRenderdefer, setSclass, setStyle, setTooltiptext, setTop, setTopDirectly, setVflex, setWidth, setWidthDirectly, setZclass, setZindex, setZIndex, setZIndexDirectly

Methods inherited from class org.zkoss.zk.ui.AbstractComponent
addAnnotation, addAnnotation, addClientEvent, addEventHandler, addEventListener, addEventListener, addForward, addForward, addForward, addForward, addMoved, addRedrawCallback, addScopeListener, addShadowRoot, addShadowRootBefore, addSharedEventHandlerMap, appendChild, applyProperties, beforeChildRemoved, beforeParentChanged, detach, didActivate, didActivate, didDeserialize, didDeserialize, disableBindingAnnotation, disableClientUpdate, enableBindingAnnotation, equals, getAnnotatedProperties, getAnnotatedPropertiesBy, getAnnotation, getAnnotation, getAnnotations, getAnnotations, getAnnotations, getAttribute, getAttribute, getAttribute, getAttributeOrFellow, getAttributes, getAttributes, getAuService, getAutag, getChildren, getClientAttribute, getClientDataAttribute, getClientEvents, getDefaultMold, getDefinition, getDesktop, getEventHandler, getEventHandlerNames, getEventListenerMap, getEventListeners, getFellow, getFellow, getFellowIfAny, getFellowIfAny, getFellows, getFirstChild, getId, getLastChild, getListenerIterator, getMold, getNextSibling, getPage, getParent, getPreviousSibling, getRedrawCallback, getRoot, getShadowRoots, getShadowVariable, getShadowVariable0, getSpaceOwner, getSpecialRendererOutput, getStubonly, getSubBindingAnnotationCount, getTemplate, getTemplateNames, getUuid, getWidgetAttribute, getWidgetAttributeNames, getWidgetClass, getWidgetListener, getWidgetListenerNames, getWidgetOverride, getWidgetOverrideNames, hasAttribute, hasAttribute, hasAttribute, hasAttributeOrFellow, hasBindingAnnotation, hasFellow, hasFellow, hasSubBindingAnnotation, invalidate, isChildable, isInvalidated, isListenerAvailable, isVisible, onWrongValue, query, queryAll, redraw, removeAttribute, removeAttribute, removeAttribute, removeChild, removeEventListener, removeForward, removeForward, removeRedrawCallback, removeScopeListener, removeShadowRoot, render, render, render, replace, response, response, response, service, setAttribute, setAttribute, setAttribute, setAuService, setAutag, setClientAttribute, setClientDataAttribute, setDefinition, setDefinition, setId, setPage, setPageBefore, setParent, setStubonly, setStubonly, setSubBindingAnnotationCount, setTemplate, setVisible, setVisibleDirectly, setWidgetAttribute, setWidgetClass, setWidgetListener, setWidgetOverride, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdateWidgetListener, smartUpdateWidgetOverride, toString, updateByClient, updateSubBindingAnnotationCount, willPassivate, willPassivate, willSerialize, willSerialize

Methods inherited from class java.lang.Object
finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Tree
```
public Tree()
```
- Method Detail
  - onPageAttached
```
public void onPageAttached(org.zkoss.zk.ui.Page newpage,
                  org.zkoss.zk.ui.Page oldpage)
```
    Specified by:
    
    onPageAttached in interface org.zkoss.zk.ui.sys.ComponentCtrl
    
    Overrides:
    
    onPageAttached in class org.zkoss.zk.ui.AbstractComponent
  - onPageDetached
```
public void onPageDetached(org.zkoss.zk.ui.Page page)
```
    Specified by:
    
    onPageDetached in interface org.zkoss.zk.ui.sys.ComponentCtrl
    
    Overrides:
    
    onPageDetached in class org.zkoss.zk.ui.AbstractComponent
  - setMold
```
public void setMold(String mold)
```
    Sets the mold to render this component.
    
    Specified by:
    
    setMold in interface org.zkoss.zk.ui.Component
    
    Overrides:
    
    setMold in class org.zkoss.zk.ui.AbstractComponent
    
    Parameters:
    mold - the mold. If null or empty, "default" is assumed. Allowed values: default, paging
    See Also:
    ComponentDefinition
  - getPaginal
```
public Paginal getPaginal()
```
    Returns the paging controller, or null if not available. Note: the paging controller is used only if AbstractComponent.getMold() is "paging".
    If mold is "paging", this method never returns null, because a child paging controller is created automatically (if not specified by developers with setPaginal(org.zkoss.zul.ext.Paginal)).
    If a paging controller is specified (either by setPaginal(org.zkoss.zul.ext.Paginal), or by setMold(java.lang.String) with "paging"), the tree will rely on the paging controller to handle long-content instead of scrolling.
    
    Since:
    
    3.0.7
  - setPaginal
```
public void setPaginal(Paginal pgi)
```
  - getPagingChild
```
public Paging getPagingChild()
```
    Returns the child paging controller that is created automatically, or null if mold is not "paging", or the controller is specified externally by setPaginal(org.zkoss.zul.ext.Paginal).
    
    Since:
    
    3.0.7
  - getPageSize
```
public int getPageSize()
```
    Returns the page size, a.k.a., the number items per page.
    
    Overrides:
    
    getPageSize in class MeshElement
    
    Throws:
    
    IllegalStateException - if getPaginal() returns null, i.e., mold is not "paging" and no external controller is specified.
    Since:
    
    2.4.1
  - setPageSize
```
public void setPageSize(int pgsz)
                 throws org.zkoss.zk.ui.WrongValueException
```
    Sets the page size, a.k.a., the number items per page.
    Note: mold is "paging" and no external controller is specified.
    
    Overrides:
    
    setPageSize in class MeshElement
    
    Throws:
    
    org.zkoss.zk.ui.WrongValueException
    Since:
    
    2.4.1
  - pgi
```
protected Paginal pgi()
```
    Description copied from class: MeshElement
    
    Returns the instance of the @{link Paginal}
    
    Specified by:
    
    pgi in class MeshElement
  - setFixedLayout
```
public void setFixedLayout(boolean fixedLayout)
```
    Deprecated. since 5.0.0, use MeshElement.setSizedByContent(boolean)(!fixedLayout) instead
    
    Parameters:
    fixedLayout - true to outline this grid by browser
  - isFixedLayout
```
public boolean isFixedLayout()
```
    Deprecated. since 5.0.0, use !MeshElement.isSizedByContent() instead
  - getTreecols
```
public Treecols getTreecols()
```
    Returns the treecols that this tree owns (might null).
  - getTreefoot
```
public Treefoot getTreefoot()
```
    Returns the treefoot that this tree owns (might null).
  - getFrozen
```
public Frozen getFrozen()
```
    Returns the frozen child.
    
    Since:
    
    7.0.0
  - getTreechildren
```
public Treechildren getTreechildren()
```
    Returns the treechildren that this tree owns (might null).
  - getHeads
```
public Collection<org.zkoss.zk.ui.Component> getHeads()
```
    Returns a collection of heads, including getTreecols() and auxiliary heads (Auxhead) (never null).
    
    Since:
    
    3.0.0
  - getRows
```
public int getRows()
```
    Returns the rows. Zero means no limitation.
    Default: 0.
  - setRows
```
public void setRows(int rows)
             throws org.zkoss.zk.ui.WrongValueException
```
    Sets the rows.
    Note: if both HtmlBasedComponent.setHeight(java.lang.String) is specified with non-empty, setRows(int) is ignored
    
    Throws:
    
    org.zkoss.zk.ui.WrongValueException
  - getName
```
public String getName()
```
    Returns the name of this component.
    Default: null.
    The name is used only to work with "legacy" Web application that handles user's request by servlets. It works only with HTTP/HTML-based browsers. It doesn't work with other kind of clients.
    Don't use this method if your application is purely based on ZK's event-driven model.
  - setName
```
public void setName(String name)
```
    Sets the name of this component.
    The name is used only to work with "legacy" Web application that handles user's request by servlets. It works only with HTTP/HTML-based browsers. It doesn't work with other kind of clients.
    Don't use this method if your application is purely based on ZK's event-driven model.
    
    Parameters:
    name - the name of this component.
  - setNonselectableTags
```
public void setNonselectableTags(String tags)
```
    Sets a list of HTML tag names that shall not cause the tree item being selected if they are clicked.
    Default: null (it means button, input, textarea and a). If you want to select no matter which tag is clicked, please specify an empty string.
    
    Parameters:
    tags - a list of HTML tag names that will not cause the tree item being selected if clicked. Specify null to use the default and "" to indicate none.
    Since:
    
    5.0.5
  - getNonselectableTags
```
public String getNonselectableTags()
```
    Returns a list of HTML tag names that shall not cause the tree item being selected if they are clicked.
    Refer to setNonselectableTags(java.lang.String) for details.
    
    Since:
    
    5.0.5
  - isCheckmark
```
public boolean isCheckmark()
```
    Returns whether the check mark shall be displayed in front of each item.
    Default: false.
  - setCheckmark
```
public void setCheckmark(boolean checkmark)
```
    Sets whether the check mark shall be displayed in front of each item.
    The check mark is a checkbox if isMultiple() returns true. It is a radio button if isMultiple() returns false.
  - isVflex
```
public boolean isVflex()
```
    Returns whether to grow and shrink vertical to fit their given space, so called vertical flexibility.
    Note: this attribute is ignored if setRows(int) is specified
    Default: false.
  - setVflex
```
public void setVflex(boolean vflex)
```
    Sets whether to grow and shrink vertical to fit their given space, so called vertical flexibility.
    Note: this attribute is ignored if setRows(int) is specified
  - setInnerWidth
```
public void setInnerWidth(String innerWidth)
```
    Sets the inner width of this component. The inner width is the width of the inner table. By default, it is 100%. That is, it is the same as the width of this component. However, it is changed when the user is sizing the column's width.
    Application developers rarely call this method, unless they want to preserve the widths of sizable columns changed by the user. To preserve the widths, the developer have to store the widths of all columns and the inner width (getInnerWidth()), and then restore them when re-creating this component.
    
    Parameters:
    innerWidth - the inner width. If null, "100%" is assumed.
    Since:
    
    3.0.0
  - getInnerWidth
```
public String getInnerWidth()
```
    Returns the inner width of this component. The inner width is the width of the inner table.
    Default: "100%"
    
    Since:
    
    3.0.0
    
    See Also:
    setInnerWidth(java.lang.String)
  - getSeltype
```
public String getSeltype()
```
    Returns the seltype.
    Default: "single".
  - setSeltype
```
public void setSeltype(String seltype)
                throws org.zkoss.zk.ui.WrongValueException
```
    Sets the seltype. "single","multiple" is supported.
    
    Throws:
    
    org.zkoss.zk.ui.WrongValueException
  - getTabindex
```
public int getTabindex()
```
    Returns the tab order of this component.
    
    Since:
    
    7.0.4
    Default: 0 (means the same as browser's default).
  - setTabindex
```
public void setTabindex(int tabindex)
                 throws org.zkoss.zk.ui.WrongValueException
```
    Sets the tab order of this component.
    
    Throws:
    
    org.zkoss.zk.ui.WrongValueException
    Since:
    
    7.0.4
  - isMultiple
```
public boolean isMultiple()
```
    Returns whether multiple selections are allowed.
    Default: false.
  - setMultiple
```
public void setMultiple(boolean multiple)
```
    Sets whether multiple selections are allowed.
    Notice that, if a model is assigned, it will change the model's state (by TreeSelectableModel.setMultiple(boolean)).
  - setActivePage
```
public void setActivePage(Treeitem item)
```
    Sets the active page in which the specified item is. The active page will become the page that contains the specified item.
    
    Parameters:
    item - the item to show. If the item is null, invisible, or doesn't belong to the same tree, nothing happens.
    Since:
    
    3.0.4
  - smartUpdate
```
public void smartUpdate(String attr,
               Object value)
```
    Overrides:
    
    smartUpdate in class org.zkoss.zk.ui.AbstractComponent
  - getItems
```
public Collection<Treeitem> getItems()
```
    Returns a readonly list of all descending Treeitem (children's children and so on).
    Note: the performance of the size method of returned collection is no good.
  - getItemCount
```
public int getItemCount()
```
    Returns the number of child Treeitem. The same as getItems().size().
    Note: the performance of this method is no good.
  - selectItem
```
public void selectItem(Treeitem item)
```
    Deselects all of the currently selected items and selects the given item.
    It is the same as setSelectedItem(org.zkoss.zul.Treeitem).
    
    Parameters:
    item - the item to select. If null, all items are deselected.
  - addItemToSelection
```
public void addItemToSelection(Treeitem item)
```
    Selects the given item, without deselecting any other items that are already selected..
  - removeItemFromSelection
```
public void removeItemFromSelection(Treeitem item)
```
    Deselects the given item without deselecting other items.
  - toggleItemSelection
```
public void toggleItemSelection(Treeitem item)
```
    If the specified item is selected, it is deselected. If it is not selected, it is selected. Other items in the tree that are selected are not affected, and retain their selected state.
  - clearSelection
```
public void clearSelection()
```
    Clears the selection.
  - selectAll
```
public void selectAll()
```
    Selects all items.
  - getSelectedItem
```
public Treeitem getSelectedItem()
```
    Returns the selected item.
  - setSelectedItem
```
public void setSelectedItem(Treeitem item)
```
    Deselects all of the currently selected items and selects the given item.
    It is the same as selectItem(org.zkoss.zul.Treeitem).
  - getSelectedItems
```
public Set<Treeitem> getSelectedItems()
```
    Returns all selected items.
  - getSelectedCount
```
public int getSelectedCount()
```
    Returns the number of items being selected.
  - clear
```
public void clear()
```
    Clears all child tree items (Treeitem.
    Note: after clear, getTreechildren() won't be null, but it has no child
  - getZclass
```
public String getZclass()
```
    Overrides:
    
    getZclass in class org.zkoss.zk.ui.HtmlBasedComponent
  - beforeChildAdded
```
public void beforeChildAdded(org.zkoss.zk.ui.Component newChild,
                    org.zkoss.zk.ui.Component refChild)
```
    Specified by:
    
    beforeChildAdded in interface org.zkoss.zk.ui.sys.ComponentCtrl
    
    Overrides:
    
    beforeChildAdded in class org.zkoss.zk.ui.AbstractComponent
  - insertBefore
```
public boolean insertBefore(org.zkoss.zk.ui.Component newChild,
                   org.zkoss.zk.ui.Component refChild)
```
    Specified by:
    
    insertBefore in interface org.zkoss.zk.ui.Component
    
    Overrides:
    
    insertBefore in class org.zkoss.zk.ui.AbstractComponent
  - onChildAdded
```
public void onChildAdded(org.zkoss.zk.ui.Component child)
```
    Specified by:
    
    onChildAdded in interface org.zkoss.zk.ui.sys.ComponentCtrl
    
    Overrides:
    
    onChildAdded in class org.zkoss.zk.ui.AbstractComponent
  - onChildRemoved
```
public void onChildRemoved(org.zkoss.zk.ui.Component child)
```
    Specified by:
    
    onChildRemoved in interface org.zkoss.zk.ui.sys.ComponentCtrl
    
    Overrides:
    
    onChildRemoved in class org.zkoss.zk.ui.AbstractComponent
  - clone
```
public Object clone()
```
    Specified by:
    
    clone in interface org.zkoss.zk.ui.Component
    
    Overrides:
    
    clone in class XulElement
  - sessionWillPassivate
```
public void sessionWillPassivate(org.zkoss.zk.ui.Page page)
```
    Specified by:
    
    sessionWillPassivate in interface org.zkoss.zk.ui.sys.ComponentCtrl
    
    Overrides:
    
    sessionWillPassivate in class org.zkoss.zk.ui.AbstractComponent
  - sessionDidActivate
```
public void sessionDidActivate(org.zkoss.zk.ui.Page page)
```
    Specified by:
    
    sessionDidActivate in interface org.zkoss.zk.ui.sys.ComponentCtrl
    
    Overrides:
    
    sessionDidActivate in class org.zkoss.zk.ui.AbstractComponent
  - getChildByNode
```
protected org.zkoss.zk.ui.Component getChildByNode(Object node)
```
    Return the Tree or Treeitem component by a given associated node in model, or null if the treeitem is not instantiated (i.e., rendered) yet. It returns this tree if the given node is the root node (i.e., TreeModel.getRoot()).
    
    Throws:
    
    IllegalStateException - if no model is assigned (setModel(org.zkoss.zul.TreeModel<?>)).
    Since:
    
    3.0.0
    
    See Also:
    renderItemByNode(java.lang.Object)
  - getChildByPath
```
protected org.zkoss.zk.ui.Component getChildByPath(int[] path)
```
    Return the Tree or Treeitem component by a path, or null if corresponding Treeitem is not instantiated (i.e., rendered) yet. It returns this tree if the given node is the root node. (i.e., TreeModel.getRoot()).
    
    Since:
    
    6.0.0
  - setModel
```
public void setModel(TreeModel<?> model)
```
    Sets the tree model associated with this tree.
    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.
    
    Parameters:
    model - the tree model to associate, or null to dissociate any previous model.
    
    Throws:
    
    org.zkoss.zk.ui.UiException - if failed to initialize with the model
    Since:
    
    3.0.0
  - onInitRender
```
public void onInitRender()
```
    Handles a private event, onInitRender. It is used only for implementation, and you rarely need to invoke it explicitly.
    
    Since:
    
    6.0.0
  - getModel
```
public <T> TreeModel<T> getModel()
```
    Returns the list model associated with this tree, or null if this tree is not associated with any tree data model.
    
    Returns:
    the list model associated with this tree
    Since:
    
    3.0.0
  - setItemRenderer
```
public void setItemRenderer(TreeitemRenderer<?> renderer)
```
    Sets the renderer which is used to render each item if getModel() is not null.
    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.
    
    Parameters:
    renderer - the renderer, or null to use the default.
    
    Throws:
    
    org.zkoss.zk.ui.UiException - if failed to initialize with the model
    Since:
    
    5.0.6
  - setItemRenderer
```
public void setItemRenderer(String clsnm)
                     throws ClassNotFoundException,
                            NoSuchMethodException,
                            IllegalAccessException,
                            InstantiationException,
                            InvocationTargetException
```
    Sets the renderer by use of a class name. It creates an instance automatically.
    
    Throws:
    
    ClassNotFoundException
    
    NoSuchMethodException
    
    IllegalAccessException
    
    InstantiationException
    
    InvocationTargetException
    Since:
    
    6.5.2
  - getItemRenderer
```
public <T> TreeitemRenderer<T> getItemRenderer()
```
    Returns the renderer to render each item, or null if the default renderer is used.
    
    Returns:
    the renderer to render each item, or null if the default
    Since:
    
    5.0.6
  - setTreeitemRenderer
```
public void setTreeitemRenderer(TreeitemRenderer<?> renderer)
```
    Deprecated. As of release 5.0.6, replaced with setItemRenderer(org.zkoss.zul.TreeitemRenderer<?>). Sets the renderer which is used to render each item if getModel() is not null.
    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.
    
    Parameters:
    renderer - the renderer, or null to use the default.
    
    Throws:
    
    org.zkoss.zk.ui.UiException - if failed to initialize with the model
    Since:
    
    3.0.0
  - getTreeitemRenderer
```
public <T> TreeitemRenderer<T> getTreeitemRenderer()
```
    Deprecated. As of release 5.0.6, replaced with getItemRenderer(). /** Returns the renderer to render each item, or null if the default renderer is used.
    
    Returns:
    the renderer to render each item, or null if the default
    Since:
    
    3.0.0
  - renderItem
```
public void renderItem(Treeitem item)
```
    Renders the specified Treeitem, if not loaded yet, with getItemRenderer().
    It does nothing if getModel() returns null.
    To unload treeitem, use Treeitem.unload().
    
    Since:
    
    3.0.0
    
    See Also:
    renderItems(java.util.Set<? extends org.zkoss.zul.Treeitem>)
  - renderItem
```
public void renderItem(Treeitem item,
              Object node)
```
    Renders the specified Treeitem, if not loaded yet, with getItemRenderer().
    It does nothing if getModel() returns null.
    Note: Since the corresponding node is given, This method has better performance than renderItem(Treeitem item) due to not searching for its corresponding node.
    To unload treeitem, use Treeitem.unload().
    
    Since:
    
    3.0.0
    
    See Also:
    renderItems(java.util.Set<? extends org.zkoss.zul.Treeitem>)
  - renderItems
```
public void renderItems(Set<? extends Treeitem> items)
```
    Renders the specified Treeitem if not loaded yet, with getItemRenderer().
    It does nothing if getModel() returns null.
    To unload treeitem, with Treeitem.unload().
    
    Since:
    
    3.0.0
    
    See Also:
    renderItem(org.zkoss.zul.Treeitem)
  - getAssociatedNode
```
protected Object getAssociatedNode(Treeitem ti,
                       Tree t)
```
    Return a node which is an associated Treeitem ti in a Tree tree
    
    Since:
    
    3.0.0
  - renderItemByNode
```
public Treeitem renderItemByNode(Object node)
```
    Load the treeitems by the given node. This method must be used with a tree model, and the node is one of the value returned by TreeModel.getChild(E, int).
    Notice that this method has to search the model one-by-one. The performance might not be good, so use renderItemByPath(int[]) if possible.
    
    Returns:
    the treeitem that is associated with the give node, or null no treeitem is associated (including the give node is the root).
    
    Throws:
    
    IllegalStateException - if no model is assigned (setModel(org.zkoss.zul.TreeModel<?>)).
    Since:
    
    5.0.6, #getChildByNode
  - renderItemByPath
```
public Treeitem renderItemByPath(int[] path)
```
    Load the treeitems by giving a path of the treeitems top open.
    Note: By using this method, all treeitems in path will be rendered and opened (Treeitem.setOpen(boolean)). If you want to visit the rendered item in paging mold, please invoke setActivePage(Treeitem).
    
    Parameters:
    path - - an index path. The first element is the index at the first level of the tree structure.
    
    Returns:
    the treeitem from tree by given path
    Since:
    
    3.0.0
  - redrawChildren
```
protected void redrawChildren(Writer out)
                       throws IOException
```
    Overrides:
    
    redrawChildren in class org.zkoss.zk.ui.AbstractComponent
    
    Throws:
    
    IOException
  - renderProperties
```
protected void renderProperties(org.zkoss.zk.ui.sys.ContentRenderer renderer)
                         throws IOException
```
    Overrides:
    
    renderProperties in class MeshElement
    
    Throws:
    
    IOException
  - isAutohidePaging
```
protected boolean isAutohidePaging()
```
    Specified by:
    
    isAutohidePaging in class MeshElement
  - isSelectOnHighlightDisabled
```
protected boolean isSelectOnHighlightDisabled()
```
  - service
```
public void service(org.zkoss.zk.au.AuRequest request,
           boolean everError)
```
    Processes an AU request.
    Default: in addition to what are handled by HtmlBasedComponent.service(org.zkoss.zk.au.AuRequest, boolean), it also handles onSelect.
    
    Specified by:
    
    service in interface org.zkoss.zk.ui.sys.ComponentCtrl
    
    Overrides:
    
    service in class org.zkoss.zk.ui.HtmlBasedComponent
    
    Since:
    
    5.0.0
  - setActivePage
```
public void setActivePage(int pg)
                   throws org.zkoss.zk.ui.WrongValueException
```
    Description copied from class: MeshElement
    
    Sets the active page (starting from 0).
    
    Overrides:
    
    setActivePage in class MeshElement
    
    Throws:
    
    org.zkoss.zk.ui.WrongValueException
  - getActivePage
```
public int getActivePage()
```
    Description copied from class: MeshElement
    
    Returns the active page (starting from 0).
    
    Overrides:
    
    getActivePage in class MeshElement
  - onAfterRender
```
public void onAfterRender()
```

Class Tree

Nested Class Summary

Nested classes/interfaces inherited from class org.zkoss.zul.impl.MeshElement

Nested classes/interfaces inherited from class org.zkoss.zk.ui.HtmlBasedComponent

Nested classes/interfaces inherited from class org.zkoss.zk.ui.AbstractComponent

Field Summary

Fields inherited from class org.zkoss.zk.ui.HtmlBasedComponent

Fields inherited from interface org.zkoss.zk.ui.Component

Fields inherited from interface org.zkoss.zk.ui.sys.ComponentCtrl

Constructor Summary

Method Summary

Methods inherited from class org.zkoss.zul.impl.MeshElement

Methods inherited from class org.zkoss.zul.impl.XulElement

Methods inherited from class org.zkoss.zk.ui.HtmlBasedComponent

Methods inherited from class org.zkoss.zk.ui.AbstractComponent

Methods inherited from class java.lang.Object

Constructor Detail

Tree

Method Detail

onPageAttached

onPageDetached

setMold

getPaginal

setPaginal

getPagingChild

getPageSize

setPageSize

pgi

setFixedLayout

isFixedLayout

getTreecols

getTreefoot

getFrozen

getTreechildren

getHeads

getRows

setRows

getName

setName

setNonselectableTags

getNonselectableTags

isCheckmark

setCheckmark

isVflex

setVflex

setInnerWidth

getInnerWidth

getSeltype

setSeltype

getTabindex

setTabindex

isMultiple

setMultiple

setActivePage

smartUpdate

getItems

getItemCount

selectItem

addItemToSelection

removeItemFromSelection

toggleItemSelection

clearSelection

selectAll

getSelectedItem

setSelectedItem

getSelectedItems

getSelectedCount

clear

getZclass

beforeChildAdded

insertBefore

onChildAdded

onChildRemoved

clone

sessionWillPassivate

sessionDidActivate

getChildByNode

getChildByPath

setModel

onInitRender