Elevator Parameters
Click an item in the list to the left to find out more about it.


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.

Elevator's width must be at least 133 pixels, due to the fixed with of the 8 level-indicators and two buttons at the top of the menu. Apart from that, it can be as wide as you like, provided that it's wide enough to display the text of your widest item.

The height must be sufficient to display the menu-level containing the most items.

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'. Remember that adding or removing items, or changing parameters such as the font, may mean that the applet's size needs to change again.

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.

3DBorder
A choice of yes or no to whether the menu should have a raised 3D border. If you choose 'no' the menu will be flat. The default is yes.

AnimateMenu
A choice of yes or no which specifies whether or not the menu slides to its new size when changing levels. The default is yes. If you choose 'no' the menu will jump to its new size immediately without using slide animation.

AnimationSpeed
A choice of normal or fast which sets the speed of Elevator's fading and sliding animation. The default is normal.

ArrowColor
If ShowArrows is set to 'yes' (its default), this parameter sets the color of the two scrolling arrows that follow mouse movement at each side of the menu. The default is BDBDCE (light gray).

BgColor
Sets the background color of the applet, with a default of 000000 (black). This is the color used for any blank space below the menu's main panel. (Note that Elevator 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).

HomeTarget
Sets the name of the frame or window in which the HomeURL (if specified) will open. If this is blank, the HomeURL will open in the frame specified by the DefaultTarget parameter.

HomeURL
When the Home button (to the right of the level-indicators) is clicked, it resets the menu to the Home level. It can also link to a particular URL at the same time if you choose, such as your site's home page. To make the Home button also act as a link, enter the absolute or relative URL it should link to in this parameter. The URL will load into the frame or window specified in the HomeTarget parameter.

IconColor
Sets the color of the icons on the Home and Down buttons at the top-right of the menu, and the text-color of the level-indicators when disabled. The default is BDBDCE (light gray).

IconFocusColor
Sets the color of the Home or Down button's icon when the mouse moves over it, and the text-color of the level-indicators when enabled. The default is 00FF00 (lime).

IconPressColor
Sets the color of a Home or Down button's icon or level-indicator when clicked. The default is 808080 (gray).

ItemFont
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.
An example font parameter would be: Comic Sans MS|Verdana|Arial|Sans,9,bold.

LocationColor
Sets the fill color of the 'location' area immediately above the menu items, which shows the name of the current level. The default is to use your chosen PanelColor.

LocationFont
Sets the name, size and style of the font to use for text in the 'location' area, showing the name of the current level. The default is Sans,8,plain. This parameter is constructed in exactly the same way as the ItemFont parameter.

LocationText
Specifies the text shown in the location area when the menu is at the lowest (Home) level. The default is Menu Contents.

LocationTextColor
Sets the color of text shown in the location area. The default is 00FF00 (lime).

PanelColor
Sets the color of Elevator's main panel, containing all the menu's indicators, panels and items. The default is 404040 (dark gray).

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).

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. If the item you choose is a link, it will be shown as selected (i.e. it will be shown in TextSelectColor). If the item you choose opens another level instead of linking somewhere, Elevator will start at that level.

SelectorColor
If ShowSelectors is set to 'yes', this sets the fill color of the selector rectangle shown when the mouse moves over a menu item. The default is 403020 (dark brown).

SelectorLineColor
if ShowSelectorLines is set to 'yes', this sets the color of the horizontal selection lines shown above and below an item when the mouse moves over it. The default is BDBDCE (light gray).

ShowArrows
A choice of yes or no to whether the scrolling arrows beside the menu items should be shown. The default is yes.

ShowSelectorLines
A choice of yes or no to whether the horizontal selection lines should be shown above and below a menu item when the mouse moves over it. The default is yes.

ShowSelectors
A choice of yes or no to whether the selection rectangle should be shown when the mouse moves over a menu item. The default is yes.

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.

SoundButtonClick
Specifies the absolute or relative URL of an MP3 audio file to play when the mouse clicks the Home or Down button. If you don't want to play a sound for this event, just leave this parameter out of your datafile.

SoundButtonRelease
Specifies the absolute or relative URL of an MP3 audio file to play when the mouse is released after clicking the Home or Down button. If you don't want to play a sound for this event, just leave this parameter out of your datafile.

SoundIndicatorClick
Specifies the absolute or relative URL of an MP3 audio file to play when the mouse clicks an enabled level-indicator. If you don't want to play a sound for this event, just leave this parameter out of your datafile.

SoundIndicatorRelease
Specifies the absolute or relative URL of an MP3 audio file to play when the mouse is released after clicking a level-indicator. If you don't want to play a sound for this event, just leave this parameter out of your datafile.

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

SoundItemRelease
Specifies the absolute or relative URL of an MP3 audio file to play when the mouse is released after clicking a menu item. 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.

TextAlign
A choice of left, center or right which sets the alignment of text for the menu items. The default is center.

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 00FF00 (lime).

TextPressColor
Sets the color of a menu item's text when clicked. The default is 00B000 (mid-green).

TextSelectColor
Sets the color of a menu item's text when the item is selected. The default is FFCE00 (mid-yellow).

VerticalLineColor
Sets the color of the 3D vertical 'shaft' lines shown at each side of the menu items. The default is to match your chosen PanelColor.

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 Elevator will display nothing useful at all.

Item1, Item2, ..., Itemn
These parameters specify the text you want Elevator to display for each item, and they also tell Elevator 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. Separator don't react to clicks, so you shouldn't include URL/Target/Message parameters for separator items. Because Elevator allows 8 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, ..., URLn
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. Items can link to a URL, or they can open a new menu level, or both. Elevator also supports a system of reserved words that can be used in the URL parameters, which let you use menu items to jump to different levels on the menus (like a type of shortcut).

Target1, Target2, ..., Targetn
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, ..., Messagen
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.