Width & Height
The width and height of the applet are set in the HTML code you add to the web page. Be sure to change the dimensions in the <object> and the <embed> tags.

Nexus's width must be enough to display your widest text item (bearing in mind that each level is indented a few pixels), plus the width of the scrollbar if it is likely to be shown.

Because Nexus can be scrolled vertically, the height can be anything you like, though of course a taller applet is easier for users to work with as it requires less scrolling.

To avoid the trial-and-error of finding the best size, set the Testmode parameter to 'yes' and click anywhere inside the applet: the minimum width and height will be shown in a tooltip message. You can then edit the HTML code and set Testmode back to 'no'.

Parameters
The parameters below should be added to your datafile in the form NAME=VALUE (for instance, BgColor=FF0000). Each parameter should be on a separate line. You can leave blank lines in the list to organize the parameters into groups if you want to. The parameter names are not case-sensitive, and neither are the values, so BgColor=FF0000 is the same as bgcolor=ff0000. You can add the parameters to your file in any order. Most parameters have a default value which we show in bold text below: if you don't include the parameter in your datafile, the default value will be used automatically.

AnimateMenu
A choice of yes or no which specifies whether or not the menu items should scroll upward and downward when items are collapsed and expanded. The default is yes. If you choose 'no', items will jump to their new positions.

BgColor
Sets the background fill color of the applet, with a default of 606060 (dark gray). (Note that Nexus can only change the background color after it has loaded. To have the same background color shown before the browser starts loading the applet, change the BgColor setting in the HTML code too.)

DefaultTarget
Every menu item can link to a separate URL, and it can open it into a separate frame or window: we provide numbered Target parameters for that. However, you probably want most (or maybe all) the links to open into one particular frame. Enter the frame name in this parameter, and every item without its own Target parameter will open the link into this 'default' frame. You can also use the HTML names _self, _top, _parent, _blank or _new. If you leave this parameter out of your datafile, links will open into _self (the frame or window containing the applet).

ExpandLinks
This parameter is a yes or no value which specifies what should happen when the user clicks a menu item which is a link and contains subitems. If you choose 'yes', the item will expand to show its subitems; if you choose 'no' it won't. The default is no. (Whichever you choose, the link will always be fired, of course.)

Font
Sets the name, size and style of font to use for the menu items, with each part separated by commas. The default is Sans,8,plain.

• Name: You can include any number of font names, separated by pipe symbols (|), and the applet will use the first font available on the user's system. To ensure compatibility, finish with one of these generic names: Sans, Serif or Typewriter.
  
• Size: The size of the font in points.
  
• Style: The style can be plain, bold, italic or bold-italic.

FullExpand
A choice of yes or no according to whether the entire tree should be shown as expanded when the applet starts. The default setting is no.

InheritColor
A yes or no parameter, with a default of yes. Each menu item can have its own individual text color, and this parameter specifies whether its subitems should use the same color as their parent ('yes') or use the default TextColor ('no').

ItemsAsButtons
A yes or no parameter, with a default of yes. This specifies whether focused and selected menu items should be displayed as 3D buttons or as flat selectors. If you choose 'no', the items will be flat.

LineColor
Sets the color of the tree-structure lines that connect all the tree items together. If you want to hide the lines, set this color to match your BgColor.

Name
Specifies a name for this instance of the applet. This is only necessary if you are using the applet in conjunction with our free Satellite add-on, and it's explained in the documentation for Satellite, available from the Cool Focus web site. If you are not using Satellite with this applet, it's best not to include this parameter in your datafile (although nothing bad will happen if you do).

ScrollBarAutohide
A choice of yes or no to specify whether the scrollbar should be hidden when no items can be scrolled. The default is yes.

ScrollBarFlatBaseColor
If ScrollBarStyle is set to 'flat', this sets the background color of the scroll area. The default is to use a brighter shade of your BgColor.

ScrollBarFlatBorderColor
If ScrollBarStyle is set to 'flat', this sets the border color of the scrollbar. The default is to use a darker shade of your BgColor.

ScrollBarFlatFillColor
If ScrollBarStyle is set to 'flat', this sets the internal fill color of the scrollbar. The default is to match your BgColor.

ScrollBarPushIn
A choice of yes or no with a default of yes. If set to 'yes', Nexus will change the appearance of the scrollbar when clicked. If ScrollBarStyle is set to '3D', the bar will be indented; if ScrollBarStyle is 'Flat' its color will darken. (There is no change is ScrollBarStyle is 'Gradient'.)

ScrollBarStyle
A choice of 3 style options for the scrollbar:

3D: a raised 3D bar on a lowered 3D background.
Flat: a flat bar with a border on a flat background.
Gradient: a flat bar filled with a vertical gradient on a flat gradient-filled background.

SelectedItem
A number which specifies the item-index of the menu item that should be selected when the menu starts. Valid values are from 1 up to the total number of items used. Enter 0 (the default) if no item should be selected.

SelectedItemExpanded
A choice of yes or no which specifies whether the initially-selected item should be expanded to show its subitems. The default is yes. This parameter is ignored if SelectedItem is set at its default of 0, or if the item selected at startup does not contain any subitems.

ShowVersion
A yes or no value. This parameter is included in all Cool Focus Flash applets, and its default is no. If set to 'yes', the version number of the applet (and other details) will be shown when the applet starts. This is included only for troubleshooting purposes, to help you determine which version of an applet you're using. It should be set to 'no' (or removed from your datafile) before you publish your page.

SoundCollapse
Specifies the absolute or relative URL of an MP3 audio file to play when an item is collapsed (hiding its subitems). If you don't want to play a sound for this event, just leave this parameter out of your datafile.

SoundExpand
Specifies the absolute or relative URL of an MP3 audio file to play when an item is expanded (revealing its subitems). If you don't want to play a sound for this event, just leave this parameter out of your datafile.

SoundLink
Specifies the absolute or relative URL of an MP3 audio file to play when a linking menu item is clicked. If you don't want to play a sound for this event, just leave this parameter out of your datafile.

Testmode
A yes or no value, with a default of 'no'. This parameter is included in most Cool Focus Flash applets, and is used to help you determine the best width and height for the applet. (Because of this, it's best to use this parameter when you've got everything in the applet the way you want it.) Set this parameter to 'yes', then view the applet in your browser and click anywhere inside the applet. You'll see the minimum width and height displayed in a tooltip message, and you can copy these values into the page's HTML code. When you're done, remember to set the Testmode parameter back to 'no' or delete it from your datafile.

Note: If you've specified a list of font names in the applet's font parameters, it's a good idea to check that the applet will be big enough whichever of those fonts is used: with Testmode set to 'yes', move each font name to the beginning of the list and refresh the page to see if Testmode reports that larger dimensions are needed.

TextColor
Sets the color of a menu item's text when not focused or selected. The default is BDBDCE (light gray).

TextFocusColor
Sets the text color of a menu item when the mouse moves over it. The default is F0F0FF (blue-white).

TextFocusUnderline
A choice of yes or no to specify whether items should gain an HTML-style underline when the mouse moves over them. The default is no. If set to 'yes', this parameter is most effective with ItemsAsButtons set to 'no', and TextSelectBorderColor and TextSelectFillColor set to match the BgColor.

TextSelectBorderColor
Sets the color of the selector border shown around selected or focused menu items. The default is to use your BgColor, effectively hiding the border. Avoid very bright or very dark colors if ItemsAsButtons is set to 'yes' because Nexus must derive lighter and darker shades of this color to create 3D borders for the buttons.

TextSelectColor
Sets the text color of the selected menu item. The default is 00FF00 (lime).

TextSelectFillColor
Sets the background color of selected or focused menu items. The default is to match your BgColor.

ToggleColor
Sets the color of the borders and the +/- symbols of toggle-boxes when unfocused. The default is BDBDCE (light gray).

ToggleFillColor
Sets the fill color of toggle-boxes when unfocused. The default is to match your BgColor.

ToggleFillFocusColor
Sets the fill color of a toggle box when the box (or the item it's linked with) is focused. The default is to match your BgColor.

ToggleFocusColor
Sets the color of the borders and +/- symbols of toggle-boxes when focused. The default is 00FF00 (lime).

TogglesAsButtons
A choice of yes to no which specifies whether toggle-boxes should be selectable 3D buttons or flat squares. Choose yes (the default) for 3D buttons.

TogglesHideBorders
A choice of yes or no, with a default of no. This parameter determines whether the borders around unexpanded toggle-boxes should be shown or hidden. Choose 'yes' to hide the borders.

Items
The parameters below create the items to appear on the menu, and the URLs they should link to when clicked. You must include at least one Item parameter, or Nexus will display nothing at all.

Item1, Item2, ..., Item_n
These parameters specify the text you want Nexus to display for each item, and they also tell Nexus which level the item should belong to. In place of text to display, you can enter a hyphen (-) to create a separator-line on the menu. Separators don't react to clicks, so you shouldn't include URL/Target/Message/Color parameters for separator items. Because Nexus allows unlimited levels of items, its Item parameters are a bit more complicated than most of our other applets. The full details of this parameter are explained in Adding Menu Items.

URL1, URL2, ..., URL_n
The optional URL to which the Item with the same number suffix should link when clicked. To make items behave like links in all respects except linking somewhere (which can be useful for testing), use a dollar sign ($, or when encoded, %24) as the first character of the URL.

Target1, Target2, ..., Target_n
The name of the frame or window into which the URL with the same number suffix should open. If you don't include this parameter, the frame name set in the DefaultTarget parameter will be used.

Message1, Message2, ..., Message_n
An optional text message which will be displayed in the browser's status bar (in compatible browsers) when the mouse moves over the Item with the same number suffix.

Color1, Color2, ..., Color_n
An optional text color for this item. Any items which don't have a matching Color parameter will use the default TextColor (or, if InheritColor is set to 'yes', the color of their parent item).