# QuickLink Text Menu

Class Files: QLTMenu.class, ocjwkey.class
Notice Tag: QuickLink Text Menu, Copyright (c) 1997 OpenCube Technologies, Registered (Unique Key ID#)

For fast customization of the applet try using one of the templates

Index

How to Use the Applet Tags
The Notice Tag
Defining Colors
Defining Multiple Attributes
The Applet Coordinate System
The Applet Parameters
The Main Menu Parameters
The Highlighted Main Menu Parameters
The Sub Menu Parameters
The URL Link Parameters
The Mouse Parameters

How to use the applet Tags:

The applet tag identifies the location, class file name, and size of a Java applet. Below is a small sample applet tag (or view the source for this document to see the applet tag for the above implementation of the QuickLink Text Menu). The first part of the tag code="QLTMenu.class" identifies the name of the Java program. The second part codebase="java/" identifies the relative location of the file (leave codebase blank if the class file is located in the same directory as the HTML document).

<applet code="QLTMenu.class" codebase="java/" width="500" height="100">
<param name="subdesc0-0"value="the first sub menu description for the first main menu">
<param name="subdesc0-1"value="the second sub menu description for the first main menu">
<param name="subdesc1-0"value="the first sub menu description for the second main menu">
</applet>

The third and fourth part of the applet tag identifies the width and height of the applet (usually measured in screen pixels).

The parameters are defined below the applet start tag with the parameter name first, followed by the value of the parameter. (see below for the complete QuickLink Text Menu parameter list). You may add as many parameters as the applet allows for, with the QuickLink Text Menu it is unlimited. (If a parameter is not working, first double check that its spelling and case are typed correctly.)

The last part works like all other HTML tags and defines the end of the applet tag </applet>.

Information about the applet and its parameters

The Notice Tag

Parameter 1 must be included in the applet tag in order for the applet to work. Most of the parameters will default if you fail to define them, however we suggest that you include all the parameters so the applet is ensured to give the desired look. Usually the easiest thing to do is cut and paste the applet tag info used in the sample and modify it to fit your web page.

Defining Colors

Color Definition: This applet uses a simple RGB color scheme. To define a color in one of the color parameters use a value between 0 - 255 for the red, green, and blue components separated by commas and typed out in the correct r,g,b order. Below is a sample of how a color parameter should look, the example specifies several different sample colors for the "bgcolor" parameter.

WHITE: <param name="bgcolor" value="255,255,255">
GREEN: <param name="bgcolor" value="0,255,0">
BLACK: <param name="bgcolor" value="0,0,0">
YELLOW: <param name="bgcolor" value="255,255,0">
OFF WHITE: <param name="bgcolor" value="240,239,234">

The best way to choose the exact color you are looking for without having to guess the numbers is to access your systems Color Picker. Color Pickers usually allow you to drag the mouse over a rainbow type color grid to select a color, and show you the appropriate RGB values. In windows the Color Picker is accessible through MS Paint as well as a majority of the popular Imaging and HTML Authoring Software.

Defining Multiple Attributes with the same parameter name

Parameters used to customize a specific image location or message are indicated using a range, such as "maindesc0" - "maindescN". To define a parameter for a specific image or message (available when noted as above), use "mainx0" to define, in this case, the x coordinate for the 1st main menu message relative to the applet - "mainx3" would define the x coordinate for the fourth main menu etc., etc.

The applet coordinate system

The origin of the applets coordinate system is located at the upper left corner of the applet. The x (horizontal) coordinate starts at the left border with 0 and goes as far to the right as the applet is wide (defined with the width tag - see above). The y (vertical) coordinate starts at the top of the applet with 0 and goes down as far as the applet is high (defined with the height tag - see above).

The Applet Parameters

The Applet

Parameter 1
Attribute: Copyright notice.
param name="Notice"
value=""QuickLink Text Menu, Copyright (c) 1997 OpenCube Technologies, Registered (Unique Key ID#)"
Note: This must be included for the applet to work.

Parameter 2
Attribute: 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 VALUE: Black

Parameter 3
Attribute: Main Menu Row Spacing
param name = "mainrowspace"
Value = X, Where X is the distance from one main menu row to the next. Note: The "mainrowspace" and "maincolspace" tags are provided for convenience, you may define a specific location for any main menu item using the "mainx" and "mainy" tags. This tag and the "maincolspace" tag is an easier way of defining main menus that are horizontally or vertically lined up. When left blank or defined as -1 the applet assumes you have defined the main menu locations using the "mainx" and "mainy" tags. You can also use this tag to layout the main menus and override any specific main menu with a different location using the "mainx" and "mainy" tags.
DEFAULT VALUE: Not Active (-1)

Parameter 4
Attribute: Main Menu Column Spacing
param name = "maincolspace"
Value = X, Where X is the distance from one column to the next. Note: see above for more information concerning this and the "mainrowspace" tags.
DEFAULT VALUE: Not Active (-1)

The Main Menus

Parameter 5
Attribute: Main Menu X (Horizontal) Locations
param name = "mainx0" - "mainxN"
Value = X, Where X is the horizontal location of the main menus left border location relative to the applets left border. Note: A value of 10 would place the first main menu 10 units to the right from the left edge of the applet. See above for more information regarding the applets coordinate system.

Parameter 6
Attribute: Main Menu Y (Vertical) Locations
param name = "mainy0" - "mainyN"
Value = X, Where X is the vertical location of the main menus top border relative to the applets top border. Note: A value of 10 would place the first main menu 10 units down form the top of the applet. See above for more information regarding the applets coordinate system.

Parameter 7
Attribute: Default Main Menu Widths
param name = "mainwidth"
Value = X, Where X is the default width for all the main menus.
DEFAULT VALUE: 100

Parameter 8
Attribute: Specific Main Menu Widths
param name = "mainwidth0" - "mainwidthN"
Value = X, Where X is the specific width of a main menu.

Parameter 9
Attribute: Default Main Menu Heights
param name = "mainheight"
Value = X, Where X is the default height for all the main menus.
DEFAULT VALUE: 25

Parameter 10
Attribute: Specific Main Menu Heights
param name = "mainheight0" - "mainheightN"
Value = X, Where X is the default height for a specific main menu.

Parameter 11
Attribute: Main Menu Text Descriptions
param name = "maindesc0" - "maindescN"
Value = X, Where X is the message to be displayed for a main menu. Note: message longer than the menu item area, defined with the "mainheight" and "mainwidth" tags, are automatically formatted to multiple lines. To force a paragraph break use a vertical bar "|" to see an example of how this works see template one on the template page.

Parameter 12
Attribute: Font Style
param name = "mainfont"
Value = X, Where X is a valid font such as "Courier". Note: this tag defines the font style to be used for all the main menus.
DEFAULT VALUE: "Arial"

Parameter 13
Attribute: Italic
param name = "mainitalic"
Value = true or false, True = Yes all main menus use an italic font style, False = No all main menus use a plain font style.
DEFAULT VALUE: False

Parameter 14
Attribute: Bold
param name = "mainbold"
Value = true or false, True = Yes all main menus use a bold font style, False = No all main menus use a plain font style.
DEFAULT VALUE: False

Parameter 15
Attribute: Default Font Sizes
param name = "mainsize"
Value = X, Where X is the default size of the font to use for all the main menus descriptions.
DEFAULT VALUE: 14

Parameter 16
Attribute: Specific Font Sizes
param name = "mainsize0" - "mainsizeN"
Value = X, Where X is the specific size of a font to use for a main menus description.

Parameter 17
Attribute: Default Text Colors
param name = "maintextcolor"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of the default text color to be used for all the main menu descriptions.
DEFAULT VALUE: Black

Parameter 18
Attribute: Specific Text Colors
param name = "maintextcolor0" - "maintextcolorN"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of a specific text color to be used for a main menu description.

Parameter 19
Attribute: Default Main Menu Background Colors
param name = "mainbgcolor"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of the default background color to be used for all the main menu items. Note: the background color fills the rectangular area defined with the "mainwidth" and "mainheight" tags.
DEFAULT VALUE: Gray

Parameter 20
Attribute: Specific Main Menu Background Colors
param name = "mainbgcolor0" - "mainbgcolorN"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of the specific background color to be used for a main menu items. Note: the background color fills the rectangular area defined with the "mainwidth" and "mainheight" tags

Parameter 21
Attribute: Default Main Menu Border Thickness
param name = "mainborderthickness"
Value = X - Where X defines the thickness of the borders for all the main menu items. Note: You may choose not to use a border at all by setting this tag to 0.
DEFAULT VALUE: 0

Parameter 22
Attribute: Specific Main Menu Border Thickness
param name = "mainborderthickness0" - "mainborderthicknessN"
Value = X - Where X defines the thickness of the specific border for a main menu items. Note: You may choose not to use a border at all by setting this tag to 0.

Parameter 23
Attribute: Default Main Menu Border Color
param name = "mainbordercolor"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of the default border color to be used for all the main menu items.
DEFAULT VALUE: Black

Parameter 24
Attribute: Specific Main Menu Border Color
param name = "mainbordercolor0" - "mainbordercolorN"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of a specific border color to be used for a main menu

Parameter 25
Attribute: Default Main Menu Text Margins
param name = "mainxoffset"
Value = X - Where X is the text offset (margin) from the left edge of the main menu items.
DEFAULT VALUE: 5

Parameter 26
Attribute: Specific Main Menu Text Margins
param name = "mainxoffset0" - "mainxoffsetN"
Value = X - Where X is the text offset (margin) from the left edge for a specific main menu.

Parameter 27
Attribute: Default Horizontal Alignment of Menu Text
param name = "mainhalign"
Value = 0,1,2,3 - 0=align left, 1=align left with margin defined with "mainxoffset" tag, 2=center horizontally, 3=align right.
DEFAULT VALUE: 2 - (Centered)

Parameter 28
Attribute: Specific Horizontal Alignment of Main Menu Text
param name = "mainhalign0" - "mainhalignN"
Value = 0,1,2,3 - 0=align left, 1=align left with margin defined with "mainxoffset" tag, 2=center horizontally, 3=align right.

Parameter 29
Attribute: Default Vertical Alignment
param name = "mainvalign"
Value = 0,1,2,3 - 0=align top, 1=align top with margin defined with "mainxoffset" tag, 2=center vertically, 3=align bottom.
DEFAULT VALUE: 2 - (Centered)

Parameter 30
Attribute: Specific Vertical Alignment
param name = "mainvalign0" - "mainvalignN"
Value = 0,1,2,3 - 0=align top, 1=align top with margin defined with "mainxoffset" tag, 2=center vertically, 3=align bottom.

The Highlighted Main Menus

Parameter 31
Attribute: Highlighted Main Menu Text Descriptions
param name = "hldesc0" - "hldescN"
Value = X, Where X is the message to be displayed for a highlighted main menu. Note: message longer than the menu item area, defined with the "mainheight" and "mainwidth" tags, are automatically formatted to multiple lines. To force a paragraph break use a vertical bar "|" to see an example of how this works see template one on the template page.

Parameter 32
Attribute: Font Style
param name = "hlfont"
Value = X, Where X is a valid font such as "Courier". Note: this tag defines the font style to be used for all the highlighted main menus.
DEFAULT VALUE: "Arial"

Parameter 33
Attribute: Italic
param name = "hlitalic"
Value = true or false, True = Yes all highlighted main menus use an italic font style, False = No all highlighted main menus use a plain font style.
DEFAULT VALUE: False

Parameter 34
Attribute: Bold
param name = "hlbold"
Value = true or false, True = Yes all highlighted main menus use a bold font style, False = No all highlighted main menus use a plain font style.
DEFAULT VALUE: False

Parameter 35
Attribute: Default Font Sizes
param name = "hlsize"
Value = X, Where X is the default size of the font to use for all the highlighted main menus descriptions.
DEFAULT VALUE: 14

Parameter 36
Attribute: Specific Font Sizes
param name = "hlsize0" - "hlsizeN"
Value = X, Where X is the specific size of a font to use for a highlighted main menus description.

Parameter 37
Attribute: Default Text Colors
param name = "hltextcolor"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of the default text color to be used for all the highlighted main menu descriptions.
DEFAULT VALUE: White

Parameter 38
Attribute: Specific Text Colors
param name = "hltextcolor0" - "hltextcolorN"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of a specific text color to be used for a highlighted main menu description.

Parameter 39
Attribute: Default Highlighted Main Menu Background Colors
param name = "hlbgcolor"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of the default background color to be used for all the highlighted main menu items. Note: the background color fills the rectangular area defined with the "mainwidth" and "mainheight" tags.
DEFAULT VALUE: Black

Parameter 40
Attribute: Specific Highlighted Main Menu Background Colors
param name = "hlbgcolor0" - "hlbgcolorN"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of the specific background color to be used for a highlighted main menu items. Note: the background color fills the rectangular area defined with the "mainwidth" and "mainheight" tags

Parameter 41
Attribute: Default Highlighted Main Menu Border Thickness
param name = "hlborderthickness"
Value = X - Where X defines the thickness of the borders for all the highlighted main menu items. Note: You may choose not to use a border at all by setting this tag to 0.
DEFAULT VALUE: 0

Parameter 42
Attribute: Specific Highlighted Main Menu Border Thickness
param name = "hlborderthickness0" - "hlborderthicknessN"
Value = X - Where X defines the thickness of the specific border for a highlighted main menu item. Note: You may choose not to use a border at all by setting this tag to 0.

Parameter 43
Attribute: Default Highlighted Main Menu Border Color
param name = "hlbordercolor"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of the default border color to be used for all the highlighted main menu items.
DEFAULT VALUE: Black

Parameter 44
Attribute: Specific Highlighted Main Menu Border Color
param name = "hlbordercolor0" - "hlbordercolorN"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of a specific border color to be used for a highlighted main menu

Parameter 45
Attribute: Default Highlighted Main Menu Text Margins
param name = "hlxoffset"
Value = X - Where X is the text offset (margin) from the left edge of the highlighted main menu items.
DEFAULT VALUE: 5

Parameter 46
Attribute: Specific Highlighted Main Menu Text Margins
param name = "hlxoffset0" - "hlxoffsetN"
Value = X - Where X is the text offset (margin) from the left edge for a specific highlighted main menu.

Parameter 47
Attribute: Default Horizontal Alignment of Main Menu Text
param name = "maincentertext"
Value = 0,1,2,3 - 0=align left, 1=align left with margin defined with "hlxoffset" tag, 2=center horizontally, 3=align right.
DEFAULT VALUE: 2 - (Center)

Parameter 48
Attribute: Specific Horizontal Alignment of Highlighted Main Menu Text
param name = "hlhalign0" - "hlhalignN"
Value = 0,1,2,3 - 0=align left, 1=align left with margin defined with "hlxoffset" tag, 2=center horizontally, 3=align right.

Parameter 49
Attribute: Default Vertical Alignment
param name = "hlvalign"
Value = 0,1,2,3 - 0=align top, 1=align top with margin defined with "hlxoffset" tag, 2=center vertically, 3=align bottom.
DEFAULT VALUE: 2 - (Center)

Parameter 50
Attribute: Specific Vertical Alignment
param name = "hlvalign0" - "hlvalignN"
Value = 0,1,2,3 - 0=align top, 1=align top with margin defined with "hlxoffset" tag, 2=center vertically, 3=align bottom.

The Sub Menus

Parameter 51
Attribute: Sub Menu Descriptions
param name = "subdesc0-0" - "subdescN-N"
Value = X - Where X is the description to be used for a specific sub menu item. Note: The first part of the index "N" in the tag identifies the main menu which this sub menu description belongs to. The second part of the index "N" identifies the sub menu position number from the top. (e.g. to define a sub menu description for the first sub menu item which belong to the first main menu use "subdesc0-0" to define the second sub menu item use "subdesc0-1". to define the third sub menu description for the 2nd main menu item use "subdesc1-2" etc. etc.)

Parameter 52
Attribute: Default Sub Menu x (horizontal) Position (offset from main menu position)
param name = "subxoffset"
Value = X, Where X is the horizontal offset of the left edge of the sub menu from the left edge of the main menus.
DEFAULT VALUE: 10

Parameter 53
Attribute: Specific Sub Menu x (horizontal) Position (offset from main menu position)
param name = "subxoffset0" - "subxoffsetN"
Value = X, Where X is the horizontal offset of the left edge of a sub menu from the left edge of its main menu.

Parameter 54
Attribute: Default Sub Menu y (vertical) Position (offset from main menu position)
param name = "subyoffset"
Value = X, Where X is the vertical offset of the top edge of the sub menu from the top edge of the main menus.
DEFAULT VALUE: 10

Parameter 55
Attribute: Specific Sub Menu y (vertical) Position (offset from main menu position)
param name = "subyoffset0" - "subyoffsetN"
Value = X, Where X is the vertical offset of the top edge of a sub menu from the top edge of its main menu.

Parameter 56
Attribute: Sub Menu Font
param name = "subfont"
Value = X, Where X is a valid font to use for the sub menus (e.g. "Courier").
DEFAULT VALUE: "Arial"

Parameter 57
Attribute: Sub Menu Font Size
param name = "subsize"
Value = X, Where X is the size of the font to use for the sub menus.
DEFAULT VALUE: 12

Parameter 58
Attribute: Italic
param name = "subitalic"
Value = true or false, True = Yes all sub menus use an italic font style, False = No all sub menus use a plain font style.
DEFAULT VALUE: False

Parameter 59
Attribute: Bold
param name = "subbold"
Value = true or false, True = Yes all sub menus use a bold font style, False = No all sub menus use a plain font style.
DEFAULT VALUE: False

Parameter 60
Attribute: Sub Menu Outline Color
param name = "suboutlinecolor"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of the sub menus outline color.
DEFAULT VALUE: Black

Parameter 61
Attribute: Sub Menu Color
param name = "subcolor"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of the sub menus background color.
DEFAULT VALUE: Yellow

Parameter 62
Attribute: Sub Menu Highlight Color
param name = "subhlcolor"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of a sub menus items highlighted background color.
DEFAULT VALUE: Red

Parameter 63
Attribute: Sub Menu Text Color
param name = "subtextcolor"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of the a highlighted sub menu items text color.
DEFAULT VALUE: Black

Parameter 64
Attribute: Sub Menu Highlight Text Color
param name = "subhltextcolor"
Value = r,g,b - Where r,g,b defines the red, green, and blue components of the sub menus highlighted text color.
DEFAULT VALUE: Black

Parameter 65
Attribute: Sub Menu Left Margin
param name = "subtextxoffset"
Value = X, Where X is the left margin to use for the sub menu descriptions.
DEFAULT VALUE: 4

Parameter 66
Attribute: Sub Menu Center Text?
param name = "subcentertext"
Value = true or false - true = yes, center text within the sub menus, false = no left justify sub menu text using the "subtextxoffset" tag as the left margin within the sub menu.
DEFAULT VALUE: False

The URL Links

Parameter 67
Attribute: Main Menu URL Links
param name = "maindesturl0" - "maindesturlN"
value=X, Where X is the link for the specific main menu item. URL's should be defined relative to the HTML document containing the applet (e.g. if document is located at www.mydomain.com/mydoc.htm and if the page you want to load is at www.mydomain.com/myfolder/mydoc2.htm the relative reference would be myfolder/mydoc2.htm)

Parameter 68
Attribute: Load Main Menu URL Links Where?
param name="mainloadwhere0" - "mainloadwhereN"
The "mainloadwhere" tag specifies where the document specified in the "maindesturlN" tag should be loaded. The default is "_self"
"_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

Parameter 69
Attribute: Sub Menu URL Links
param name = "subdesturl0-0" - "subdesturlN-N"
value=X, where X is the link for the specific sub menu URL to load. (e.g. to define a link for the first main menus first sub menu message use "desturl0-0" for the second use "desturl0-1", etc., to define a URL link for the third main menus second sub menu message us "desturl2-1", etc., etc.) Fully qualify all URL's (e.g. "http://www.opencube.com"). URL's should be defined relative to the HTML document containing the applet (e.g. if document is located at www.mydomain.com/mydoc.htm and if the page you want to load is at www.mydomain.com/myfolder/mydoc2.htm the relative reference would be myfolder/mydoc2.htm)

Parameter 70
Attribute: Load Sub Menu URL Links Where?
param name="subloadwhere0-0" - "subloadwhereN-N"
The "subloadwhere" tag specifies where the document specified in the "subdesturlN-N" tag should be loaded. The default is "_self"
"_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

Parameter 71
Attribute: Default Load Where
param name="loadwhere"
The "loadwhere" tag specifies where the documents specified in the "subdesturlN-N" tag and "maindesturlN" tags should be loaded. The default is "_self" Note: this tag is useful for defaulting all the menu links, if you define a default using this tag it will only be overridden with a specific loadwhere parameter when defined.
"_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

QuickLink Text Menu, © 1997, OpenCube Technologies