Enhanced JTable rendering information is provided through com.creamtec.ajaxswing.support.TableSupport interface. It allows specifying a row-level context menu that is displayed in the browser when a user clicks right mouse button on a table row. The row is selected and if a menu is provided it is displayed to the user. When the user clicks on a menu item a request is sent to the server where the actions are emulated on JTable.

Enhanced JTree rendering information is provided through com.creamtec.ajaxswing.support.TreeSupport interface. It allows specifying node-level context menus and custom node images. Context menu is displayed in the browser when a user clicks right mouse button on a tree node. The node is selected and if a menu is provided it is displayed to the user. When the user clicks on a menu item a request is sent to the server where the actions are emulated on JTree.

Custom node images can be specified either through a through a path to the image resource or a custom image bundle. If the implementation of TreeSupport.getNodeImagePath() returns a non-null string, it is used for the rendered node. If getNodeImagePath() returned null, then the default path is looked up in TreeSupport.DEFAULT_NODE_IMAGE_NAMES map based on the node type (folder/item) and state (expanded/collapsed). getNodeImagePath() is useful for nodes that do not have children because their image doesn't change. Folders (nodes with children) use different images for expanded and collapsed state, and these images are flipped through JavaScript in the browser. To support custom images for folders a custom image bundle has to instantiated and placed into ajaxSwingTreeImageBundles global object in JavaScript under a user-defined bundle name. That bundle name should be returned for the node from TreeSupport.getNodeImageBundleName(). The bundle name is used by JavaScript when a node image has to be changed in the browser in response to expand/collapse user action. The current implementation requires duplication of certain information between JavaScript and Java due to performance reasons. The following steps describe a possible implementation:

• Create a subdirectory for tree images in the selected theme (e.g. AjaxSwing/tomcat/webapps/ajaxswing/Windows_docs/images/custom_tree) and copy your images there. Note that you have to provide custom version of each image that AjaxSwing is using for tree (see TreeSupport.DEFAULT_NODE_IMAGE_NAMES for a complete list)
• Create a Java class that extends JTree and implements TreeSupport interface (e.g. CustomTree)
• Implement getNodeImageBundleName() to return the name of your bundle (e.g. "custom")
• Implement getNodeImagePath() to return relative paths to your images (see com.creamtec.ajaxswing.ui.CustomTree in the src folder for an example)
• Create a JavaScript function in AjaxSwing/tomcat/webapps/ajaxswing/scripts/custom.js that creates a custom image bundle object and registers it with AjaxSwing tree:
  

      function createCustomTreeImageBundle() {
          if (ajaxSwingTreeImageBundles['custom'] == null) {
              // Initialize custom tree data only once
              var bundle = new Object();
              bundle['IMG_BLANK']                      = getDocsURL() + '/images/custom_tree/Blank.gif'
              bundle['IMG_LINE']                       = getDocsURL() + '/images/custom_tree/Line.gif'
              bundle['IMG_ITEM']                       = getDocsURL() + '/images/custom_tree/Item.gif'
              bundle['IMG_LAST_ITEM']                  = getDocsURL() + '/images/custom_tree/LastItem.gif'
              bundle['IMG_FOLDER_EXPANDED']            = getDocsURL() + '/images/custom_tree/FolderOpen.gif'
              bundle['IMG_FOLDER_COLLAPSED']           = getDocsURL() + '/images/custom_tree/FolderClosed.gif'
              bundle['IMG_LAST_FOLDER_EXPANDED']       = getDocsURL() + '/images/custom_tree/FolderLastOpen.gif'
              bundle['IMG_LAST_FOLDER_COLLAPSED']      = getDocsURL() + '/images/custom_tree/FolderLastClosed.gif'
              bundle['IMG_ROOT_FOLDER_EXPANDED']       = getDocsURL() + '/images/custom_tree/RootFolderOpen.gif'
              bundle['IMG_ROOT_FOLDER_COLLAPSED']      = getDocsURL() + '/images/custom_tree/RootFolderClosed.gif'
              bundle['IMG_ROOT_LAST_FOLDER_EXPANDED']  = getDocsURL() + '/images/custom_tree/RootLastFolderOpen.gif'
              bundle['IMG_ROOT_LAST_FOLDER_COLLAPSED'] = getDocsURL() + '/images/custom_tree/RootLastFolderClosed.gif'
              ajaxSwingTreeImageBundles['custom'] = bundle;
          }
      }
  

• Call createCustomTreeImageBundle() from customOnLoad() in custom.js 

You are done!