|
LiveWire 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.
LiveWire's height must be sufficient to display the lowest item on the menu containing the largest number of items. If you have limited space available, you can fit the applet into a smaller vertical space by removing the statusbar or reducing the spacing between items.
The width must be sufficient to display the text of each 'menu' caption. It must also be wide enough to display all of an item's subitems: LiveWire will choose whether subitems appear to the left or right of their parent item according to where there is the most space, but if the total width of the subitems is too wide, LiveWire can do nothing to help! To fit the applet into a narrower space, look at the MenubarIndent and CaptionSpacing parameters. You can also change the order in which menu captions appear in the applet, so that a menu containing a wide row of subitems is placed close to the left or right edges of the applet.
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.
AnimationSpeed
A non-case-sensitive choice of normal, faster or fast to set the speed of LiveWire's animation. The default is normal.
CaptionColor
Sets the text color of menu captions when unfocused. The default color is F0F0Ff (blue-white).
CaptionFocusColor
Sets the text color of a menu caption when the mouse moves over it, or its items are visible. The default is E000E0 (purple).
CaptionFont
Sets the name, size and style of font to use for the menu captions, 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.
CaptionSpacing
Specifies the number of pixels of horizontal space to be placed between each menu caption. The default value is 14 pixels, and the minimum is 0.
CloseOnExit
A choice of yes or no to specify whether the open menu is collapsed when the mouse moves out of the applet. If set to 'no', the menu will remain open. The default is yes.
DefaultTarget
Every Caption, Item and Subitem 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 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).
HorizontalLineColor
Sets the color of the two horizontal lines dividing the menu bar and the main panel (and dividing the main panel from the status bar is ShowStatusbar is set to 'yes'). The default is CC00CC (purple).
ItemColor
Sets the text color of an Item when unfocused. The default is F0F0FF (blue-white).
ItemExtraSpacing
Specifies the number of pixels of extra vertical space to be placed between each item. The default is 2. Any numeric value is valid here, including negative numbers, to increase or decrease the amount of vertical space between each item.
ItemFocusColor
Sets the text color of an item when the mouse moves over it or when its subitems are visible. The default is E000E0 (purple).
ItemFont
Sets the name, size and style of font to use for the Items, with each part separated by commas. The default is Sans,8,plain. This parameter should be constructed in the same way as CaptionFont.
MarkerColor
Sets the color of the two scrolling 'marker' shapes that follow the mouse movement in the applet. The default is F0F0FF (blue-white).
MarkerFocusColor
Sets the color of the scrolling markers when the mouse moves over a menu item or subitem. The default is FF0000 (red).
MarkerStyle
Specifies the shape of the two scrolling markers, with a choice of square or arrow. The default is square.
MenuBarColor
Sets the color of the menu bar strip at the top of the applet. The default is 000000 (black).
MenuBarIndent
Specifies the number of pixels by which the first menu caption is indented from the left of the applet. The default is 5, and this is also the minimum (to allow space for the vertical line and marker beside the first caption's items).
PanelColor
Sets the color of the main area of the applet where the items and subitems are shown. The default is 230078 (navy).
SelectedCaption
A number from 0 upwards to specify which Caption (if any) should be highlighted and expanded when LiveWire starts. The default is 0, meaning that no caption will be expanded.
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.
Note: If the applet is not registered, this information will always be shown when the applet starts, regardless of the ShowVersion parameter's setting.
ShowVerticalLine
A choice of yes or no (with a default of yes) to whether the vertical line should be shown beside the columns of items.
SoundClick
Specifies the absolute or relative URL of an MP3 audio file to play when the mouse is clicked on a linking caption, item or subitem. If you don't want to play a sound for this event, just leave this parameter out of your datafile.
SoundRelease
Specifies the absolute or relative URL of an MP3 audio file to play when the mouse is released after clicking a linking caption, item or subitem. If you don't want to play a sound for this event, just leave this parameter out of your datafile.
ShowStatusbar
A choice of yes or no to whether the integral status bar should be shown at the bottom of the applet. The default is yes. If you choose 'no', the two StatusBar parameters below will be ignored, as will the Message parameters provided for each caption, item and subitem.
StatusBarColor
If ShowStatusbar is set to 'yes' (its default), this sets the color of the bar. The default is 000000 (black).
StatusFont
Sets the name, size and style of font to use for text shown in the integral status bar (if ShowStatusbar is set to 'yes'), with each part separated by commas. The default is Sans,8,plain. This parameter should be constructed in the same way as CaptionFont.
StatusTextColor
If ShowStatusbar is set to 'yes' (its default), this sets the color of text shown in the integral status bar. The default is F0F0FF (blue-white).
SubSeparatorColor
Sets the color of the SubSeparatorText that separates each subitem. The default is FF0000 (red).
SubSeparatorText
Specifies the text to use to separate each subitem. This should usually be a symbol and/or spaces, or it can be blank if no symbol or additional space is wanted. The default is a colon (:).
SubitemColor
Sets the text color of an Subitem when unfocused. The default is F0F0FF (blue-white).
SubitemFocusColor
Sets the text color of a subitem when the mouse moves over it. The default is FF0000 (red).
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.
VerticalLineColor
If ShowVerticalLine is set to 'yes', this sets the color of the vertical line that appears beside each column of items. The default is E000E0 (purple).
Captions
The four parameters below place 1st-level 'captions' into the menu. These are arranged horizontally like an operating-system menu bar. Clicking a caption can link to a web page or other resource, and hovering over a caption can display a column of 2nd-level Items. You must include at least one Caption parameter, or LiveWire will display nothing at all!
The parameters all have numbers after their names, and the numbers must be consecutive, starting from 1. If you want to show 5 captions, but you forget to include a Caption4 parameter, LiveWire will stop looking for any more, and will only find captions 1 to 3.
Caption1, Caption2, ..., Captionn
These parameters specify the text you want LiveWire to display for each caption. The captions will displayed in numerical order, starting from 1, and you can include as many captions as you like, limited only by the width of the applet.
URL1, URL2, ..., URLn
The optional URL to which the Caption with the same number should link when clicked. If you don't want the item to act as a link, don't include a URL parameter for it. 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. Note: If you want a Caption to contain 2nd-level items, its URL will be ignored and it will not act as a link.
Target1, Target2, ..., Targetn
The name of the frame or window into which the URL with the same number 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 Caption with the same number.
Items
The next four parameters create columns of 2nd-level items for each Caption, which are shown when the mouse moves over a caption. They are all prefixed with a number and a hyphen. The number refers to the Caption you are adding this item to: 1-Item1 is the first item added to Caption1. 1-Item2 is the second item for Caption1 and so on. To add items to Caption3, you would use 3-Item1, 3-Item2, and so on.
The URL, Target and Message parameters for the item should be numbered exactly the same way as the Item parameter they work with. An item can contain subitems, or it can be a link, but not both. If an item has subitems, its URL and Target parameters will be ignored and it won't act as a link.
1-Item1, 1-Item2, ..., 1-Itemn
These parameters specify the text you want LiveWire to display for each item. The items will displayed in numerical order, starting from 1, and you can include as many items for each caption as you like, limited only by the height of the applet.
1-URL1, 1-URL2, ..., 1-URLn
The optional URL to which the Item with the same numeric prefix and 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.
1-Target1, 1-Target2, ..., 1-Targetn
The name of the frame or window into which the URL with the same number should open. If you don't include this parameter, the frame name set in the DefaultTarget parameter will be used.
1-Message1, 1-Message2, ..., 1-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 numeric prefix and suffix.
Subitems
The next four parameters create rows of 3rd-level items for each Item, which are shown when the mouse moves over an item. They are all prefixed with two numbers and hyphens. The first number refers to the Caption you are adding this subitem to, and the second number refers to the Item containing the subitem. So:
1-1-Item1 is the first subitem added to the first Item in Caption1.
1-1-Item2 is the second subitem added to the first Item in Caption1.
3-2-Item4 is the fourth subitem added to the second Item in Caption3.
The URL, Target and Message parameters for the subitem should be numbered exactly the same way as the Item parameter they work with.
1-1-Item1, 1-1-Item2, ..., 1-1-Itemn
These parameters specify the text you want LiveWire to display for each subitem. You can include as many subitems as you want, limited only by the width of the applet.
1-1-URL1, 1-1-URL2, ..., 1-1-URLn
The optional URL to which the subitem with the same numeric prefixes and suffix should link when clicked.
1-1-Target1, 1-1-Target2, ..., 1-1-Targetn
The name of the frame or window into which the URL with the same numeric prefixes and suffix should open. If you don't include this parameter, the frame name set in the DefaultTarget parameter will be used.
1-1-Message1, 1-1-Message2, ..., 1-1-Messagen
An optional text message which will be displayed in the browser's status bar (in compatible browsers) when the mouse moves over the subitem with the same numeric prefixes and suffix.
|