itree.java

Tree taglib,生成树的标签库

     */
    public void expandParentAndSelf(String nodeId);

    /**
     * Collapses the node with the given node id and its parent.
     * If no node exists with the given node id, nothing happens.
     * If the node has no parent, only the node itself is collapsed.
     * @param nodeId The node id of the node to collapse (plus its parent).
     */
    public void collapseParentAndSelf(String nodeId);

    /**
     * Expands the children, if any, of the node with the given node id.
     * If no node exists with that node id, or the node has no children, nothing happens.
     * @param nodeId The id of the node to expand the children of.
     */
    public void expandChildren(String nodeId);

    /**
     * Collapses the children, if any, of the node with the given node id.
     * If no node exists with that node id, or the node has no children, nothing happens.
     * @param nodeId The id of the node to collapse the children of.
     */
    public void collapseChildren(String nodeId);

    /**
     * Expands the node and its children, if any, of the node with the given node id.
     * If no node exists with that node id, nothing happens. If the node has no children
     * only the node itself is expanded.
     * @param nodeId The id of the node to expand + expand the children of.
     */
    public void expandChildrenAndSelf(String nodeId);


    /**
     * Collapses the node and its children, if any, of the node with the given node id.
     * If no node exists with that node id, nothing happens. If the node has no children
     * only the node itself is collapsed.
     * @param nodeId The id of the node to collapse + collapse the children of.
     */
    public void collapseChildrenAndSelf(String nodeId);


    /**
     * Expands all ancestors of the node with the given node id.
     * If no node exists with the given node id, nothing happens.
     * If the node has no ancestors nothing happens.
     * @param nodeId The node id of the node to expand all ancestors of.
     */
    public void expandAncestors(String nodeId);

    /**
     * Collapses all ancestors of the node with the given node id.
     * If no node exists with the given node id, nothing happens.
     * If the node has no ancestors nothing happens.
     * @param nodeId The node id of the node to collapse all ancestors of.
     */
    public void collapseAncestors(String nodeId);

    /**
     * Expands all ancestors + the node itself of the node with the given node id.
     * If no node exists with the given node id, nothing happens.
     * If the node has no ancestors only the node itself is expanded.
     * @param nodeId The node id of the node to expand + expand all ancestors of.
     */
    public void expandAncestorsAndSelf(String nodeId);

    /**
     * Collapses all ancestors + the node itself of the node with the given node id.
     * If no node exists with the given node id, nothing happens.
     * If the node has no ancestors only the node itself is collapsed.
     * @param nodeId The node id of the node to collapse plus collapse all ancestors of.
     */
    public void collapseAncestorsAndSelf(String nodeId);

    /**
     * Expands all descendants of the node with the given node id.
     * If no node with the given node id exists, or the node has no
     * descendants, nothing happens.
     * Only descendants that have children are expanded.
     * @param nodeId The node id of the node to expand all descendants of.
     */
    public void expandDescendants(String nodeId);

    /**
     * Collapses all descendants of the node with the given node id.
     * If no node with the given node id exists, or the node has no
     * descendants, nothing happens.
     * Only descendants that have children are collapsed.
     * @param nodeId The node id of the node to collapse all descendants of.
     */
    public void collapseDescendants(String nodeId);

    /**
     * Expands the node with the given node id plus all it's descendants.
     * If node node exists with the given node id, nothing happens.
     * If the node has no descendants, only the node itself is expanded.
     * Only descendants that have children are expanded.
     * @param nodeId The node to expand plus expand all descendants of.
     */
    public void expandDescendantsAndSelf(String nodeId);

    /**
     * Collapses the node with the given node id plus all it's descendants.
     * If node node exists with the given node id, nothing happens.
     * If the node has no descendants, only the node itself is collapsed.
     * Only descendants that have children are collapsed.
     * @param nodeId The node to collapse plus collapse all descendants of.
     */
    public void collapseDescendantsAndSelf(String nodeId);

    /**
     * Unselects the nodes with the given node ids. Non-existing node ids are ignored.
     * @param nodeIds The node ids of the nodes to unselect.
     */
    public void unSelect(String[] nodeIds);

    /**
     * Selects the nodes with the given node ids. Non-existing node ids are ignored.
     * @param nodeIds The node ids of the nodes to select.
     */
    public void select(Collection nodeIds);

    /**
     * Unselects the nodes with the given node ids. Non-existing node ids are ignored.
     * @param nodeIds The node ids of the nodes to unselect.
     */
    public void unSelect(Collection nodeIds);

    /**
     * Selects all nodes in the tree.
     */
    public void selectAll();

    /**
     * Selects all descendants of a given node.
     * If no node exists with the given node id, nothing happens.
     * If the given node has node descendants, nothing happens.
     * @param nodeId The node id of the node to expand the descendants of.
     */
    public void selectDescendants(String nodeId);

    /**
     * Unselects all descendants of a given node.
     * If no node exists with the given node id, nothing happens.
     * If the given node has node descendants, nothing happens.
     * @param nodeId The node id of the node to unselect the descendants of.
     */
    public void unSelectDescendants(String nodeId);

    /**
     * Selects the node plus all its descendants.
     * If no node exists with the given node id, nothing happens.
     * If the node has no descendants only the node itself is selected.
     * @param nodeId The id of the node to select plus select all descendants of.
     */
    public void selectDescendantsAndSelf(String nodeId);

    /**
     * Unselects the node plus all its descendants.
     * If no node exists with the given node id, nothing happens.
     * If the node has no descendants only the node itself is unselected.
     * @param nodeId The id of the node to unselect plus unselect all descendants of.
     */
    public void unSelectDescendantsAndSelf(String nodeId);

    /**
     * Selects the parent of the node with the given node id.
     * If no node exists with the given node id, or the node has
     * no parent, nothing happens.
     * @param nodeId The node id of the node to select the parent of.
     */
    public void selectParent(String nodeId);

    /**
     * Unselects the parent of the node with the given node id.
     * If no node exists with the given node id, or the node has
     * no parent, nothing happens.
     * @param nodeId The node id of the node to unselect the parent of.
     */
    public void unSelectParent(String nodeId);

    /**
     * Selects the node with the given node id plus its parent.
     * If no node exists with the given node id nothing happens.
     * If the node has no parent only the node itself is selected.
     * @param nodeId The id of the node to select plus select its parent.
     */
    public void selectParentAndSelf(String nodeId);

    /**
     * Unselects the node with the given node id plus its parent.
     * If no node exists with the given node id nothing happens.
     * If the node has no parent only the node itself is unselected.
     * @param nodeId The id of the node to unselect plus unselect its parent.
     */
    public void unSelectParentAndSelf(String nodeId);

    /**
     * Selects all ancestors of the node with the given node id.
     * If no node exists with the given node id, or the node
     * has no ancestors, nothing happens.
     * @param nodeId The node id of the node to select all ancestors of.
     */
    public void selectAncestors(String nodeId);

    /**
     * Unselects all ancestors of the node with the given node id.
     * If no node exists with the given node id, or the node
     * has no ancestors, nothing happens.
     * @param nodeId The node id of the node to unselect all ancestors of.
     */
    public void unSelectAncestors(String nodeId);

    /**
     * Selects the node plus all ancestors of the node with the given node id.
     * If no node exists with the given node id, nothing happens.
     * If the node has no ancestors only the node itself is selected.
     * @param nodeId The id of the node to select plus select all ancestors of.
     */
    public void selectAncestorsAndSelf(String nodeId);

    /**
     * Unselects the node plus all ancestors of the node with the given node id.
     * If no node exists with the given node id, nothing happens.
     * If the node has no ancestors only the node itself is unselected.
     * @param nodeId The id of the node to unselect plus unselect all ancestors of.
     */
    public void unSelectAncestorsAndSelf(String nodeId);


    /**
     * Selects the children of the node with the given node id.
     * If no node exists with the given node id, or the node has
     * no children, nothing happens.
     * @param nodeId The id of the node to select the children of.
     */
    public void selectChildren(String nodeId);

    /**
     * Unselects the children of the node with the given node id.
     * If no node exists with the given node id, or the node has
     * no children, nothing happens.
     * @param nodeId The id of the node to unselect the children of.
     */
    public void unSelectChildren(String nodeId);

    /**
     * Selects the node and the children of the node with the given node id.
     * If no node exists with the given node id nothing happens.
     * If the node has no children only the node itself is selected.
     * @param nodeId The id of the node to select the children of.
     */
    public void selectChildrenAndSelf(String nodeId);

    /**
     * Unselects the node and the children of the node with the given node id.
     * If no node exists with the given node id nothing happens.
     * If the node has no children only the node itself is unselected.
     * @param nodeId The id of the node to unselect the children of.
     */
    public void unSelectChildrenAndSelf(String nodeId);


    /**
     * Returns an ITreeNode array of all the nodes from the node with the given node id and up to the root
     * (or from the root down to the node).
     * The root node has index 0, and the node with the given node id will have index nodepath.length-1
     * (last node in the array).
     * @param nodeId The node id of the node to get the node path of.
     * @return The path as nodes from the node and up to the root (or from the root down to the node).
     */
    ITreeNode[] getNodePath(String nodeId);

    /**
     * Sets the filter to use on this tree. An ITreeFilter can filter out nodes
     * that you do not want displayed in the tree, but for practical reasons do
     * not want to remove from the tree entirely.
     * @param filter The filter to use with this tree.
     */
    public void setFilter(ITreeFilter filter);

    /**
     * Returns the filter to use on this tree. An ITreeFilter can filter out nodes
     * that you do not want displayed in the tree, but for practical reasons do
     * not want to remove from the tree entirely.
     * @return The currently used tree filter.
     */
    public ITreeFilter getFilter();


    /**
     * Sets whether or not event listeners are notified if a select / expand etc. method is
     * called with a node id of a node that is already expanded. Set notifyOnChangeOnly to true
     * if you only want the listeners notified when a node is expanded / selected etc. that was not
     * already expanded. False if all calls to expand / select should notify the listeners even if
     * the node was already expanded / selected. Default is true.
     *
     * @param notifyOnChangeOnly True to notify listeners only when tree changes status.
     *          False to notify whenever expand / selecte etc. is called regardless of whether
     * the given node was already expanded / selected.
     */
    public void setNotifyOnChangeOnly(boolean notifyOnChangeOnly);

    /**
     * Returns whether the tree is in notifyOnChangeOnly mode or not. See
     * setNotifyOnChangeOnly for more info.
     * @see   setNotifyOnChangeOnly(boolean notifyOnChangeOnly);
     * @return True if the tree is in notifyOnChangeOnly mode. False if not.
     */
    public boolean isNotifyOnChangeOnly();
  }