Upgrading to TreeView 2.0             

Along with new features added to this version of TreeView, some other changes have been made to parameter names that will have impact upon your current implementation of TreeView. These changes bring TreeView's parameter names into line with more recent Cool Focus applets and should help to make all our applets easier to understand and use.

Required Changes

  • The first change relates to the parameters named with an 'F' prefix in v1.0, such as F1-Label1, F1-URL1, etc. To match our other menu applets, the 'F' prefix has been removed for these parameter names. To keep your current implementation, simply delete the leading 'F' from each of these parameter names.

  • Another name change relates to the URL and Target parameters. For each 'page' entry, up to four URLs can now be opened with a single click, so each URL and Target parameter name now takes an a, b, c or d suffix. In order to preserve your existing Treeview implementation, even if you want each 'page' to continue linking to just one URL, you'll need to add the a suffix to each of your existing URL and Target parameter-names.

  • Three new parameters have been added allowing you to specify the names and locations of the audio files you want to use: OpenSound, CloseSound and LinkSound. Apart from the obvious benefits of using any .au format file you like, this also lets you use TreeView on multiple pages, running them all from the same base directory, and still have individual sound setups for each. If you use sounds in your current implementation of TreeView, you'll need to add one or more of these parameters to your code giving the filename(s) and location(s).

  • The OutlineShading parameter of v1.0, which allowed a choice of 'light' or 'dark', has been replaced with a new OutlineImage parameter. The multiple image files used to build the tree structure in the previous version have been gathered into a single GIF image file, and a choice of image-sets is included in this new version. The OutlineImage parameter lets you specify the name of the image-set you want to use. If you currently have your OutlineShading parameter set to 'dark', replace it with the OutlineImage parameter with the value darkimg.gif. If your OutlineShading parameter is set to 'light', use the new parameter with the value lightimg.gif.

  • The default value for the Message parameters is now blank rather than noting the URL that the link points to.

  • The FolderCount and individual PageCount parameters of v1.0 have been retired, leaving the applet to work out the answers for itself. This means that you can remove those parameters from your existing implementation, but if you don't, v2.0 will simply ignore them.

    Optional Additions

  • A new BgImage parameter lets you place an automatically scaled JPEG or GIF image behind the applet instead of a solid block color.

  • A folder can now act as a link rather than as a container for 'pages'. To make a folder function as a link, add an appropriately numbered URL parameter (and optionally a Target parameter) for the folder.

  • Any link (Folder or Page) can now open up to four URLs into four frame or window Targets by adding a, b, c or d suffixes to the end of the parameter-names.

  • A new LeftIndent parameter allows the entire tree structure to shifted away from the left edge of the applet, which can create a more pleasing layout when using a background image that doesn't blend into the body of the page.


    • .