svn commit: r355252 - /beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsTree.xml

[st...@apache.org]

Author: steveh
Date: Thu Dec  8 14:35:21 2005
New Revision: 355252

URL: http://svn.apache.org/viewcvs?rev=355252&view=rev
Log:
Last checkin should have included Carlin's example tree rendering class.

Modified:
    beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsTree.xml

Modified: beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsTree.xml
URL: http://svn.apache.org/viewcvs/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsTree.xml?rev=355252&r1=355251&r2=355252&view=diff
==============================================================================
--- beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsTree.xml (original)
+++ beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsTree.xml Thu Dec  8 14:35:21 2005
@@ -383,35 +383,47 @@
                     <li>configure NetUI to use your extended class to render the tree</li>
                 </ol>
                 <p>
-                    A schematic custom TreeRenderer class appears below:
+                    An example custom TreeRenderer class appears below.  This class overrides the method
+                    renderConnectionImageSuffix() so that a new line is not added after the
+                    &lt;img> element for the connetcting expand/collapse image and
+                    renderSelectionLinkPrefix() so that no white space indentation is placed
+                    before the anchor used to select a node. Also, the methods renderItemIconPrefix() and renderItemIconSuffix()
+                    are overridden to wrap a &lt;span> around the &lt;img> element for the node icon. A &lt;span>
+                    might be used to incorporate CSS styles or a call to a JavaScript routine.
                 </p>
                 <source>
-package tree.renderer;
+package mytree.renderer;
 
-import org.apache.beehive.netui.tags.rendering.*;
-import org.apache.beehive.netui.tags.tree.AttributeRenderer;
-import org.apache.beehive.netui.tags.tree.InheritableState;
+import org.apache.beehive.netui.tags.rendering.AbstractRenderAppender;
 import org.apache.beehive.netui.tags.tree.TreeElement;
 import org.apache.beehive.netui.tags.tree.TreeRenderer;
 
-public class TestTreeRenderer extends TreeRenderer
+public class MyTreeRenderer extends TreeRenderer
 {
-    protected void renderIndentation(AbstractRenderAppender writer, 
-                                     TreeElement node, 
-                                     int level, 
-                                     InheritableState state)
-    {
-        // your code here... 
-    }
+   protected void renderConnectionImageSuffix(AbstractRenderAppender
+writer,
+                                              TreeElement node)
+   {
+   }
 
-    protected void renderItemIcon(AbstractRenderAppender writer,
-                                  TreeElement node,
-                                  AttributeRenderer attrs,
-                                  InheritableState state)
-    {
-        // your code here...
-    }
+   protected void renderSelectionLinkPrefix(AbstractRenderAppender writer,
+                                            TreeElement node)
+   {
+   }
 
+   protected void renderItemIconPrefix(AbstractRenderAppender writer,
+                                       TreeElement node)
+   {
+       writer.append("&lt;span ID=\"myItemIcon\" style=\"cursor:pointer;\"");
+       writer.append(" onClick=\"doSomething()\">");
+   }
+
+   protected void renderItemIconSuffix(AbstractRenderAppender writer,
+                                       TreeElement node)
+   {
+       writer.append("&lt;/span>");
+   }
+                    
     // more overridden methods...                    
 }
                     
@@ -420,7 +432,7 @@
                     To configure NetUI to use your custom TreeRenderer, edit the <a href="site:config_tree_renderer_class">&lt;tree-renderer-class></a> element of the beehive-netui-config.xml file
                     to refer to your custom class: 
                 </p>
-                <source>&lt;tree-renderer-class>tree.renderer.MyTreeRenderer&lt;/tree-renderer-class></source>
+                <source>&lt;tree-renderer-class>mytree.renderer.MyTreeRenderer&lt;/tree-renderer-class></source>
             </section>
         </section>
     </body>