3 The options parameter

3.1 All options are optional

All options are optional. diputree has reasonable defaults for every option in the options parameter. Although defaults exist you should not count on the values of these defaults, they may change over time. So, if you want to implement a special ‘look and feel’ you should declare your own options.

3.2 containershiftx, containershifty, noncontainershiftx and noncontainershifty

3.3 textshiftx

a:containershifty,b:noncontainershifty, c:containershiftx, d: noncontainershiftx e: textshiftx

3.4 backgroundcolor, linecolor, textcolor, selectedcolor, selectedbackgroundcolor, tipcolor, tipbackgroundcolor and mouseovercolor

Colors are represented by a hexadecimal value. The first 2 digits are for the red component, the next 2 for the green component and the final 2 for the blue component.
The value of a color component can range from 00 to FF ( 00 = no intensity, FF = full intensity)
e.g. FFFFFF is the hexadecimal representation of white, 000000 is black.

Example

<param name="options" value="
^backgroundcolor|0099CC
^linecolor|000080
^textcolor|FFFF00
^selectedcolor|FFFFFF
^selectedbackgroundcolor|008000
^tipcolor|008000
^tipbackgroundcolor|FFFFFF
^mouseovercolor|FFFFFF
">

3.5 marginup, margindown, marginleft and marginright

A: marginup, B: marginleft, C: margindown, D: marginright

3.6 showroot

Show the root entry or hide the root entry. Even though you hide the root entry, it still exists and has to be declared in the entries parameter. You can use this option to create a ‘multiple root’ effect.
Possible values are 0 and 1 ( 0 = don’t show, 1 = show ).

 

showroot = 1 showroot = 0

 

3.7 scrollvarverticaldivider, scrollbarhorizontaldivider and scrollbarwidth

The initial size (100%) and the scrollbardivider value control the representation of the scrollbar. It can be divided by an integer value of 1 or greater.
e.g. a divider value of 3 will give a 33% coverage of the scrollbar.

 

<param name="options" value="
^scrollbarhorizontaldivider|1
^scrollbarverticaldivider|1
">
<param name="options" value="
^scrollbarhorizontaldivider|3
^scrollbarverticaldivider|3
">

3.8 frame

Your web document can be divided into different frames. Every frame acts as a container for another web document, effectively creating a hierarchy of (contained) subdocuments.

You can assign a name to each frame individually. By default your browser assigns names to some special frames, such as: _blank (a new frame), _self (this frame), _parent (this frame’s parent) and _top (the uppermost parent frame, the root of the frame hierarchy).

3.9 showline, showicons and showstatus

You can individually switch icons, the connecting lines and status messages on and off.
Possible values are 0 and 1 ( 0 = don’t show, 1 = show ).

Examples:

<param name="options" value="
^showlines|0
">

<param name="options" value="
^showicons|0
">

3.10 fontprofile and fontalignment

3.11 tipwait and tipfontprofile

Pop up tips are small messages that pop up whenever there is no user action during a specified period.

3.12 grouping

Non-containers can be grouped together. If grouping is disabled entries will be displayed in the order they were entered.
Possible values are 0 and 1 (0 = don’t group, 1 = group ).

3.13 baseurl

If you use relative URL’s then baseurl is used to complete your URL.

So if all your link URL’s are located in a directory " /mydirectory" at your web site "http://www.mywebsite.com" than you can define a baseurl "http://www.mywebsite.com/mydirectory".
Now you only have to use the filenames of your URL’s instead of the complete URL in your links parameter.

The default URL for baseurl is the URL of the directory that contains the applet.
So if your applet is located in "http://www.mysite.com/mydirectory/diputree.class", then the baseurl will be "http://www.mysite.com/mydirectory".

baseurl is used in the links parameter.