Infinite Icon Menus Documentation
 
Sample Implementation
Template Based on Sample Implementation
 
Applet Parameters Index
General Settings
Background Image
Main Menu Images
Sub Menu Descriptions and Format
Icon Images
Sub Menu Coordinate Settings
Sub Menu Level Settings
URL Links
 
General Settings

Copyright notice.
param name="Notice"
value="Infinite Icon Menus, Copyright (c) 2000, OpenCube Inc.)"
Note: This must be included for the applet to work. The text must appear as one continuous line of text without a line break or the applet will not recognize the string, the appropriate capitalization must be used as well.

Applet Background Color
param name = "bgcolor"
Value = R,G,B, Where R,G,B are the red, green, and blue components of the applets background color.

Default Status Bar Text when mouse is over applet
param name = "onsbtext"
value="X", where X is the message to appear in the status bar when the mouse is over the applet but not over a URL link.
DEFAULT: OpenCube - Infinite Menus Menu

Default Status Bar Text when mouse is off applet
param name = "offsbtext"
value="X", where X is the message to appear in the status bar when the mouse is not over the applet.
DEFAULT: Java by OpenCube

Loading Images Message
param name = "loadmsg"
value="X", where X is the message to appear in the applet area while the sub menu icon and background images are loading.
DEFAULT: Loading Images...

Loading Images Message Color
param name = "loadmsgcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: White

 
Background Image

Background Image File Name
param name = "bgimagefile"
Value = X. Where X is the relative location and name of the image file to be displayed in the applets background.

Background Image X,Y Location
param name = "bgimagexy"
Value = X,Y. Where X,Y is the horizontal and vertical coordinate location to display the background image at, relative to the top left corner of the applet.
DEFAULT: 0,0

 
Main Menu Images

Image File Locations and Names
param name = "imagefile0" - "imagefileN"
Value = X. Where X is the relative location and name of the image file to be displayed in the applet area as a main menu image. This file must be defined relative to the location of the HTML document which contains the applet or by fully qualified.

Image x,y Coordinates
param name = "picxy0" - "picxyN"
Value = X,Y. Where X,Y is the horizontal and vertical coordinates of the image relative to the top-left corner of the applet. Note: The index must correspond to the associated "imagefile" parameter (see above).
DEFAULT: 0,0

Switch (highlight) Image File Locations and Names
param name = "switchfile0" - "switchfileN"
Value = X. Where X is the relative location and name of the image file to be displayed in the applet area when the mouse is over a main menu image. This must be defined relative to the location of the HTML document which contains the applet or be fully qualified. Note: The index must correspond to the index used with the "imagefile" parameter (see above).

 
Sub Menu Descriptions and Format

Sub Menu Descriptions and Associated Icons
param name = "desc0-0-0..." - "descN-N-N..."
Value = 'Icon Index ID|Description' or 'Description' only.

Where the index value corresponds to a main menu image as well as its parent sub menu if applicable. To define level 1 sub menus (the first menu to appear as the mouse moves over an image) use "descN-N", e.g. "desc0-0" refers to the first sub menu description for the first image, "desc0-1" refers to the second sub menu description for the first image. To branch another sub menu off a previous sub menu extend the reference, e.g. "desc0-1-0" would force a new menu to pop up as the mouse passed over the second description in the first sub menu which was defined by "desc0-1", "desc0-1-1" would add another description to this new second level sub menu. Sub menus may be branched indefinitely in any configuration.


To associate an icon with the description use the icons index id followed by a vertical bar "|" then the description for the sub menu, e.g. "0|my sub menu description" would create a sub menu link using the icon and switch icon defined with "iconfile0" and "iconswitchfile0" along with the description "my sub menu description". To use just a text description without an icon ignore the vertical bar separator and specify the description only in the value.

Font Style
param name = "font"
Value = Font Face, Style, Size, Each value must be separated by a comma and appear in the correct order (font face, style, and size) The Allowable Java font face values are Helvetica, TimesRoman, Courier, Dialog, or DialogInput. The allowable style options are plain, bold, bolditalic, or italic.
DEFAULT: Helvetica, plain, 12

Text Color
param name = "menutextcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Black

Menu Bit Height
param name = "menubitheight"
Value = X, Where X is the height of an individual sub menu description link. If left undefined or if defined smaller than the height of the font being used the height is automatically set.
DEFAULT: Not Used (Automatic according to font size)

Left and Right Margins
param name = "lrmargin"
Value = X, Where X is the left and right margin to use for the sub menu messages.
DEFAULT: 4

Icon to Text Distance
param name = "icontextspace"
Value = X, Where X is the distance in pixels to separate the icons from the text under any alignment scenario.
DEFAULT: 1

Default Icon & Text Alignment
param name = "italign"
Value = X, Where X = 0,1,2, or 3. Each value corresponds to specific text and icon alignment. Note: the text and icon alignment may also be defined for a specific sub menu (see below for more information)
1 = icon left, text left
2 = text left, icon right
3 = icon right, text left
4 = icon right, text right

DEFAULT: 0

Note: To specify the alignment of a given sub menu use the sub menus base index value used with the "desc0-0-0..." - "descN-N-N..." tags, e.g. "italign0" would refer to the first images initial sub menu, "italign0-1" would refer to the second level sub menu which appears as the mouse passes over the second sub menu description of the first images initial sub menu, etc.

Specific Icon & Text Alignment
param name = "italign0-0..." - "italignN-N..."
Value = X, Where X = 0,1,2, or 3. Each value corresponds to specific text and icon alignment. Note: the text and icon alignment may also be defined for a specific sub menu (see below for more information)
1 = icon left, text left
2 = text left, icon right
3 = icon right, text left
4 = icon right, text right

 
Icon Images

An unlimited number of icon images in varying sizes and formats may be defined and associated with any sub menu link. Each icon is optionally referenced from the "desc" tag by using the icons id which is the numbered index used in the parameter to uniquely specify the file name and location of the icon image. For more information on how to add an icon reference to a menu link see the descriptions for the "desc" tag. The icons associated switch image is automatically displayed when a sub menu link is highlighted. Note: The icons are automatically indented by the amount specified using the left and right margin parameter (see "lrmargin").

Icon Files
param name = "iconfile0" - "iconfileN"
Value = X. Where X is the name and relative location of the icon image file.The file should be defined relative to the location of the document containing the applet or fully qualified (e.g. http://www.mydomain.com/...).

Icon Switch (highlight) Files
param name = "iconswitchfile0" - "iconswitchfileN"
Value = X. Where X is the name and relative location of the icon switch image file.The file should be defined relative to the location of the document containing the applet or fully qualified (e.g. http://www.mydomain.com/...).

 
Sub Menu Coordinate Settings

NOTE: The applet will attempt to automatically place your sub menus, if left undefined, according to icon alignment and proximity to the lower and right applet edge. However the placement may be such that the sub menu is cut off by the edge of the applet, if this is the case or the applets automatic sub menu placement is not agreeable, its position may be specifically defined using the menuxy parameter described below.

Note: To specify the coordinates of a given sub menu use the sub menus base index value (defined with the "desc0-0-0..." - "descN-N-N..." tags, e.g. "menuxy0" would refer to the first images initial sub menu, "menuxy0-1" would refer to the second level sub menu which appears as the mouse passes over the second sub menu description of the first images initial sub menu, etc.

Sub Menu X,Y Coordinate
param name = "menuxy0-0..." - "menuxyN-N..."
Value = X,Y Where X,Y is the horizontal and vertical coordinates relative to the top-left corner of the sub menus associated image or sub menu.
DEFAULT: 0,0

 
Sub Menu Level Settings

NOTE: Each sub menu level can be customized with specific colors, background images, etc. To point to a specific sub menu level use the param name (customizable options listed below) with an index value stating with 0, e.g. to define the text color for the first level sub menus use "menutextcolor0", "menutextcolor1" would define the color of the second level sub menus, etc. Specifying one of the level customization parameters without an index will force all sub menus to default to that value unless specifically defined.

Default Sub Menu Background Image File Name and Location
param name = "subbgfile"
Value = X. Where X is the relative location and name of the image file to be displayed as the sub menus default background image. This file must be defined relative to the location of the HTML document which contains the applet or by fully qualified. Note: The default background image is used on all sub menu level unless defined differently for a specific level, the background image is automatically tiled to fit the sub menu area.

Specific Sub Menu Background Image File Name and Location
param name = "subbgfile0" - "subbgfileN"
Value = X. Where X is the relative location and name of the image file to be displayed as the specific sub menus background image. This file must be defined relative to the location of the HTML document which contains the applet or by fully qualified. Note: The background image is automatically tiled to fit the sub menu area.

Default Sub Menu Background Color
param name = "menucolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Yellow

Specific Sub Menu Background Color
param name = "menucolor0" - "menucolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

Default Text Color
param name = "menutextcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Black

Specific Text Color
param name = "menutextcolor0" - "menutextcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

Default Sub Menu Box Outline Color
param name = "menuboxoutcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Black

Specific Sub Menu Box Outline Color
param name = "menuboxoutcolor0" - "menuboxoutcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

Default Sub Menu Description Outline Color
param name = "menuoutcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Not Used

Specific Sub Menu Description Outline Color
param name = "menuoutcolor0" - "menuoutcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

Default Sub Menu Highlight Outline Color
param name = "menuhlcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Not Used

Specific Sub Menu Highlight Outline Color
param name = "menuhlcolor0" - "menuhlcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

Default Sub Menu Highlight Text Color
param name = "menuhltextcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Blue

Default Sub Menu Highlight Text Color
param name = "menuhltextcolor0" - "menuhltextcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

 
URL Links

Main Menu Image URL Links
param name = "imagedesturl0" - "imagedesturlN"
value=URL | Target or URL, where URL is the link for the specific sub menu message. URL's can be defined relative to the HTML document containing the applet or fully qualified (e.g. http://www.mydomain.com/...).

The desturl value can optionally be separated by a | to define a specific target location for the URL. To specifically target a named frame, set the value to the URL, than use a vertical bar delimiter ' |' followed by the name of the frame or use the URL link in combination with the constants listed below. The default target location is the value set with the loadwhere tag which defaults to "_self". e.g. a URL link which loads in a frame named content... "...myfolder/mylink.htm|content", e.g. a URL link which uses the default target location... "...myfolder/mylink.htm".

"_self" show in the current frame
"_parent" show in the parent frame
"_top" show in the top-most frame
"_blank" show in a new unnamed top-level window
"name" show in a new top-level window named name
"frame name" show in the frame named frame name

Sub Menu Level URL Links
param name = "desturl0-0-0..." - "desturlN-N-N..."
value=URL | Target or URL, where URL is the link for the specific sub menu message. The "N-N-N" index must correspond to the sub menus associated desc index (see the "desc" tag for more information). URL's can be defined relative to the HTML document containing the applet or fully qualified (e.g. http://www.mydomain.com/...).

The desturl value can optionally be separated by a | to define a specific target location for the URL. To specifically target a named frame, set the value to the URL, than use a vertical bar delimiter ' |' followed by the name of the frame or use the URL link in combination with the constants listed below. The default target location is the value set with the loadwhere tag which defaults to "_self". e.g. a URL link which loads in a frame named content... "...myfolder/mylink.htm|content", e.g. a URL link which uses the default target location... "...myfolder/mylink.htm".

"_self" show in the current frame
"_parent" show in the parent frame
"_top" show in the top-most frame
"_blank" show in a new unnamed top-level window
"name" show in a new top-level window named name
"frame name" show in the frame named frame name

Default Load Destination URL Where?
param name="loadwhere"
The "loadwhere" tag specifies where the document specified in the "desturlN-N-N" and "imagedesturlN" parameters should be loaded. The default is "_self". A value equal to the name (case sensitive) of a frame will load the document in that frame.
"_parent" show in the parent frame
"_top" show in the top-most frame
"_self" show in the current frame
"_blank" show in a new unnamed top-level window
"name" show in a new top-level window named name
"frame name" show in the frame named frame name

Note: When targeting a frame location with the name of the frame make certain that the case and names are typed identically. If the applet cannot find the frame the document will be loaded in a new window.