 |
arameter
Descriptions
Each of the
parameters for the TextURLButtonBar applet is described in detail in
this section.
 |
APPLET tag
A few of the more commonly used attributes for
the applet tag are described below.
WIDTH="pixels"
HEIGHT="pixels"
|
These required attributes give the width and height (in pixels) of the button
bar display area. These values should match the size of the button bar, or the
size of the background (if the background image is
used).
Note: the applet WIDTH and HEIGHT attributes are used by
the applet to determine if the button bar has a vertical or horizontal
orientation. If the applet size is wider than it is high, then the button bar is
assumed to have a horizontal orientation; otherwise, the button bar is assumed
to have a vertical orientation.
This optional attribute specifies the base URL of the applet -- the directory
that contains the applet's code. If this attribute is not specified, then the
document's URL is used.
This required attribute gives the name of the file that contains the applet's
compiled Applet subclass. This file is relative to the base URL of the applet.
It cannot be absolute. This attribute should be set as: CODE="TextURLButtonBar.class"
This optional attribute
specifies any text that should be displayed if the browser understands the
APPLET element but cannot run applets written in Java.
This optional attribute specifies the alignment of the applet. The possible values
of this attribute are the same as those for the IMG element: left, right, top,
texttop, middle, absmiddle, baseline, bottom, absbottom.
VSPACE="pixels"
HSPACE="pixels"
|
These option attributes specify the number of pixels above and below the applet (VSPACE)
and on each side of the applet (HSPACE). They're treated the same way
as the IMG element's VSPACE and HSPACE attributes. |
|
useCodeBase
If this parameter is omitted or has a value of "false", then the applet
will look for the background and/or texture
image files (if specified) beginning in the directory where the HTML file is
located.
If the value for this parameter is "true", then the applet
will look for the background and/or texture
image files (if specified) beginning in the directory where the Java class files are
located. |
|
orient
Normally, the applet will automatically establish
the orientation of the button bar based on the applet's dimensions.
If the width of the button bar is greater than its height, then the button bar
is assumed to have a horizontal orientation. If the height is greater than the
width, then the applet is assumed to have a vertical orientation.
Occasionally, this method of determining the button bar's orientation might not
be correct. In these cases, you can manually specify the button bar orientation
by using the orient parameter.
A parameter value of "h"
will tell the applet that the button bar has a horizontal orientation, while a
parameter value of "v" will tell the applet that the button bar is
orientated vertically.
If this parameter is not specified, then the
applet will automatically determine the button bar's orientation.
|
|
stick
If this parameter is set to "true", then when a button
on the button bar is clicked it will "stick" in the button down position until
another button is clicked. This can be useful if the button bar is in a frame and is used
for site navigation (for example). The user can easily see what button (i.e. what page)
that he/she last selected.
If this parameter is set to a button number (i.e., stick="1" would correspond
to the first button on the button bar), then that button will be "stuck" in the
button down position when the button bar initializes.
If a value for this
parameter is not specified, then the the value will default to "false"
(buttons will not "stick", but rather will pop-up as soon as the mouse button
is released).
|
|
barWidth
Normally, the applet will automatically create
the button bar so that the width of the button bar matches the width of the
applet. However, if a background is being used, then
you might want the button bar width to be less than the total width of the
applet so that the background can be seen to the left and/or right of the button
bar (see the barXPos and barYPos
parameters for information about positioning a button bar on a background
image).
If a value for this parameter is not specified, then the width
of the button bar will be the same as the applet's width. |
|
barHeight
Normally, the applet will automatically create
the button bar so that the height of the button bar matches the height of the
applet. However, if a background is being used, then
you might want the button bar height to be less than the total height of the
applet so that the background can be seen to the top and/or bottom of the button
bar (see the barXPos and barYPos
parameters for information about positioning a button bar on a background
image).
If a value for this parameter is not specified, then the height
of the button bar will be the same as the applet's height. |
|
background
This is the file name of a GIF or JPEG image file
that is displayed behind the button bar.
If a path to the image file is specified, then the path
root is based on the document's URL (i.e., the location of the web page's HTML
file), unless the useCodeBase parameter has a value
of "true" (in which case the path root is based on the URL of the Java
class files).
When the button bar is displayed, the
background image (if specified) is drawn first, then the button bar is drawn on
top of the background image. This can be useful, for instance, if you wish to
surround your button bar with a custom graphic, such as a frame.
The
position of the button bar on the background image is specified by the
barXPos and
barYPos parameters.
If you use a background
for a button bar, you will normally want the set the size of the button bar
manually using the barWidth and/or the
barHeight parameters.
Note that if a
background image is specified, the button bar will not be displayed until the
background image file has been loaded.
If this parameter is not
specified, then the applet will not draw a button bar background. |
|
barXPos
This parameter is only used if the
background parameter is specified.
The
barXPos parameter is used to position the button bar horizontally on the
background image.
The left edge of the background image is at position
0 (zero).
If a background image is specified but the barXPos parameter
is not specified, then the value for barXPos defaults to zero. |
|
barYPos
This parameter is only used if the
background parameter is specified.
The
barYPos parameter is used to position the button bar vertically on the
background image.
The top edge of the background image is at position 0
(zero).
If a background image is specified but the barYPos parameter is
not specified, then the value for barYPos defaults to zero. |
|
color
This parameter specifies the default background
color of the button bar (do not confuse this with the background
image parameter).
The value for this parameter can be a RGB value in hexadecimal format (for
instance, the color red would be "FF0000", and a medium gray would be
"888888"), or if the background parameter is specified,
then the color parameter can be omitted to create a "clear" button bar background.
A "clear" background will allow the background
image to be seen under the buttons.
You can override the default button bar background color value for a particular
button by using the buttonXXColor parameter. For instance,
if you are using a background image and if you
have not specified the color parameter, then the button text and the button borders will be
drawn on top of the background image. If you would like to have one button on the button bar colored
red, then you can use the buttonXXColor parameter to color
that single button red, while keeping a "clear" background for all of the
other buttons on the button bar.
If a value for this parameter is not specified, and if the background
parameter is not specified, then the background color will
default to white. |
|
font
This parameter specifies the default font be used
when drawing button text.
The font name can be any of the standard Java
fonts (e.g. "Dialog", "Helvetica", "TimesRoman", "Courier",
or "Symbol").
You can override this default value for a
particular button by using the buttonXXFont
parameter.
If a value for this parameter is not specified, then the
button font will default to "Dialog". |
|
fontSize
The default size of the default button bar text
font is assigned using this parameter.
You can
override this default value for a particular button by using the
buttonXXFontSize parameter.
If a value
for this parameter is not specified, then the button font size will default to "10". |
|
fontStyle
The default style of the default button bar text
font is assigned using this parameter.
The value
for the style parameter can be any one of the following: "plain", "bold",
"italic", "italic+bold", or "bold+italic".
You
can override this default value for a particular button by using the
buttonXXFontStyle parameter.
If a value
for this parameter is not specified, then the button font style will default to
"plain". |
|
fontColor
This parameter is used to assign the default
color to be used when drawing button text on the button bar.
You can
override this default value for a particular button by using the
buttonXXFontColor parameter.
The value
for this parameter must be a RGB value in hexadecimal format. For instance, the
color red would be "FF0000", and a medium gray would be "888888".
If
a value for this parameter is not specified, then button text color will default
to blue. |
|
fontColorOver
This parameter is used to assign the default
button text color used when the mouse is moved within a button's boundaries. For
instance, you could set fontColor to blue, and
fontColorOver to yellow. Whenever the mouse is moved over a button, the button
text will change from blue to yellow; when the mouse is moved off of the button,
then the text will change from yellow back to blue.
You can override
this default value for a particular button by using the
buttonXXFontColorOver parameter.
The
value for this parameter must be a RGB value in hexadecimal format. For
instance, the color red would be "FF0000", and a medium gray would be "888888".
If
a value for this parameter is not specified, then the color will default to the
same value as the fontColor. |
|
fontColorDown
This parameter is used to assign the default
button text color used when the mouse is clicked on a button. For instance, you
could set fontColor to blue, fontColorOver
to yellow, and fontColorDown to red. Whenever the mouse is moved over a button,
the text color will change from blue to yellow and when the button is clicked,
the button text will change from yellow to red. When the mouse button is
released, then the text will change from red back to yellow and when the mouse
is moved off of the button, the text color will change from yellow back to blue.
You
can override this default value for a particular button by using the
buttonXXFontColorDown parameter.
The
value for this parameter must be a RGB value in hexadecimal format. For
instance, the color red would be "FF0000", and a medium gray would be "888888".
If
a value for this parameter is not specified, then the color will default to the
same value as the fontColorOver. |
|
align
The default alignment of button text within each
button is controlled using this parameter.
There are three valid values
that this parameter accepts: "left", "center", and "right".
You
can override this default value for a particular button by using the
buttonXXAlign parameter.
If a value for
this parameter is not specified, then the button text alignment will default to
"center". |
|
texture
Instead of using a solid background
color for the button bar, you may texture the background
using an image file.
This parameter is used to specify the file name of
a GIF or JPEG image file that will be applied as a texture to the button bar.
If a path to the image file is specified, then the path
root is based on the document's URL (i.e., the location of the web page's HTML
file), unless the useCodeBase parameter has a value
of "true" (in which case the path root is based on the URL of the Java
class files).
The
texture is applied by copying the image from the image file to the button bar
area. If the texture area is smaller than the button bar area, then the texture
image will be tiled on the button bar. This allows you to fill the entire button
bar area using a very small texture image rather than using a large image that
matches the button bar dimensions (this would take longer to load). Note that
you can use an image (e.g., a photo) that matches (or exceeds) the
button bar size, if you desire.
If your button bar contain spaces
between buttons, you might want to use the textureButtonsOnly
parameter as well.
This parameter can be omitted if you do not wish to
use a texture. |
|
textureButtonsOnly
If a texture is being
used for the button bar, then this parameter can be used to specify that only
buttons (and not spaces between buttons) should be textured.
Normally
if a texture is used, the entire button bar area is textured. If you have
arranged buttons on the button bar so that space exists between one or more
buttons (see the buttonXXStart and
buttonXXSize parameters for information about button
spacing), you might wish to have only the buttons textured so that they are more
easily seen on the button bar.
If this parameter is set to "true",
then only buttons will be textured. If the parameter value is set to "false",
then the entire button bar area will be textured.
Note that if the
texture parameter is not specified, then this parameter
is ignored.
If a value is not specified for this parameter, then its
value will default to "false". |
|
buttonBorders
This parameter controls whether borders are
drawn around buttons.
The four valid values for this parameter are
(these values are case sensitive):
- "all" - borders are drawn around the buttons on all button bars
- "none" - borders are not drawn around buttons
- "base" - borders are drawn around buttons on the base button bar only
- "other" - borders are drawn around buttons on all button bars except the base button bar
If button borders are drawn, then the border characteristics are
determined by the parameters
borderColorTL, borderColorBR,
borderIntensity, and borderSize.
If
a value for this parameter is not specified, then the parameter value will
default to "none". |
|
borderColorTL
Normally, button borders (see the
buttonBorders parameter) are drawn by "lightening"
or "darkening" the borders around a button image by the percentage
specified by the borderIntensity parameter.
However, it is possible to manually specify a solid color to use when drawing a
border.
This parameter allows you to manually specify the color used to
draw the top and left button borders.
The value for this parameter must
be a RGB value in hexadecimal format. For instance, the color red would be "FF0000",
and a medium gray would be "888888". |
|
borderColorBR
Normally, button borders (see the
buttonBorders parameter) are drawn by "lightening"
or "darkening" the borders around a button image by the percentage
specified by the borderIntensity parameter.
However, it is possible to manually specify a solid color to use when drawing a
border.
This parameter allows you to manually specify the color used to
draw the bottom and right button borders.
The value for this parameter
must be a RGB value in hexadecimal format. For instance, the color red would be
"FF0000", and a medium gray would be "888888". |
|
borderIntensity
Normally, button borders (see the
buttonBorders parameter) are drawn by "lightening"
or "darkening" the borders around a button image by the percentage
specified by this parameter.
Lightening and darkening button borders
instead of using solid colors can result in some interesting effects as the
button text or button texture can become part of the
border.
If you prefer to manually specify solid border colors, see the
borderColorTL and the borderColorBR
parameters.
The value for this parameter must be between "0"
and "100" percent.
If a value for this parameter is not
specified, then the value will default to "50" percent. |
|
borderSize
If borders are drawn for buttons (see the
buttonBorders parameter), then this parameter will
determine the width of the border that surrounds each button.
If a
value for the borderSize parameter is not specified, then the value will default
to "1". |
|
downShift
When the mouse is clicked while over a button,
you can specify that the button image be offset or "shifted" down and
to the right. This gives the illusion that the button has been depressed.
If
this parameter is assigned a value of "true", then when the mouse is
clicked on a button it will be shifted down and to the right by the number of
pixels specified by the
downShiftAmt parameter. Note that downShift can be
enabled regardless of whether borders (see the
buttonBorders parameter) are being drawn for the
buttons or not.
One thing to bear in mind when using the downShift
parameter is that the downShift effect is produced by copying the button image,
moving it down and to the right, then drawing it over the original button image.
In some circumstances portions of the original button text might be left in the
border region resulting in a less-than-desirable appearance. In this situation,
it is recommended that you use solid color borders (see the
borderColorTL and borderColorBR
parameters).
This parameter's value can be either "true" or "false".
If the parameter is not assigned a value, then the value will default to "false"
(buttons will not be shifted). |
|
downShiftAmt
If buttons are shifted down and to the right when
they are clicked (see the downShift parameter), then
this parameter will determine the number of pixels that the button will be
shifted.
If a value for the downShiftAmt parameter is not specified,
then the value will default to the value of the borderSize
parameter. |
|
baseBrighten
If the value of this parameter is greater than
zero, then the "brightness" of the base button bar will be increased by the specified
percentage.
If the value of this parameter is less than
zero, then the "brightness" of the base button bar will be decreased by the specified
percentage.
If a value for this parameter is not specified, then the brightness of the base button bar
will remain unchanged.
Note that the value for this parameter may be less than "-100" or greater than "100", but
a point will be reached (depending on the colors being brightened) when decreasing or increasing the parameter
value will have no effect.
|
|
baseBrightenTint
This parameter is a color that is used to"tint" the base button bar when it is
"brightened" (see also the related baseBrighten parameter).
For instance, if you want to give all of the buttons in
the base button bar a reddish tint, then you might specify the tint color:
|
<PARAM NAME="baseBrightenTint" VALUE="330000">
|
It is important to note that in order to tint the button bar, the baseBrighten parameter must be assigned
a value other than zero (the value can be positive or negative).
Also, note that tinting is an additive process. This means that if you use a bright tint color, then the original
colors in the button bar will be brightened. It might be necessary to specify a negative value for
the baseBrighten parameter in order to prevent the button bar from having a "washed out" appearance.
The tinting process is performed internally by adding the RGB values of the tint color to the RGB values of each pixel
in the base button bar image. The resulting image is then "brightened" by the percentage specified
by the mouseOverBrighten parameter.
For instance, suppose that the base button bar is a solid red color
("ff0000") and a green tint value is specified ("00ff00").
In this case the resulting base button bar color would be yellow
("ff0000" + "00ff00" = "ffff00").
This resulting yellow would then be "brightened" by the percentage specified by the
baseBrighten parameter.
Usually a small tint value will yield the best results. For instance, a red only tint value
of "180000" will appear nearly black on it's own, but when added to the colors in
the button image will result in the button image having a reddish tint. If a larger red value was used,
for instance "ff0000", the button would probably appear far too red (large values can,
however, be useful). The moral is, start small and then increase the tint color value a little at a time until the desired
effect is achieved. Also, don't forget to experiment with adjusting the baseBrightenTint
parameter value in combination with the baseBrighten parameter value.
The value for this parameter must
be a RGB value in hexadecimal format. For instance, the color red would be "FF0000",
and a medium gray would be "888888".
|
|
mouseOverBrighten
If the value of this parameter is greater than
zero, then the "brightness" of the mouseOver button bar will be increased by the specified
percentage.
If the value of this parameter is less than
zero, then the "brightness" of the mouseOver button bar will be decreased by the specified
percentage.
If a value for this parameter is not specified, then the brightness of the mouseOver button bar
will remain unchanged.
Note that the value for this parameter may be less than "-100" or greater than "100", but
a point will be reached (depending on the colors being brightened) when decreasing or increasing the parameter
value will have no effect.
|
|
moBrightenTint
This parameter is a color that is used to"tint" the mouseOver button bar when it is
"brightened" (see also the related mouseOverBrighten parameter).
For instance, if you want to give all of the buttons in
the mouseOver button bar a reddish tint, then you might specify the tint color:
|
<PARAM NAME="moBrightenTint" VALUE="330000">
|
It is important to note that in order to tint the button bar, the mouseOverBrighten parameter must be assigned
a value other than zero (the value can be positive or negative).
Also, note that tinting is an additive process. This means that if you use a bright tint color, then the original
colors in the button bar will be brightened. It might be necessary to specify a negative value for
the mouseOverBrighten parameter in order to prevent the button bar from having a "washed out" appearance.
The tinting process is performed internally by adding the RGB values of the tint color to the RGB values of each pixel
in the mouseOver button bar image. The resulting image is then "brightened" by the percentage specified
by the mouseOverBrighten parameter.
For instance, suppose that the mouseOver button bar is a solid red color
("ff0000") and a green tint value is specified ("00ff00").
In this case the resulting mouseOver button bar color would be yellow
("ff0000" + "00ff00" = "ffff00").
This resulting yellow would then be "brightened" by the percentage specified by the
mouseOverBrighten parameter.
Usually a small tint value will yield the best results. For instance, a red only tint value
of "180000" will appear nearly black on it's own, but when added to the colors in
the button image will result in the button image having a reddish tint. If a larger red value was used,
for instance "ff0000", the button would probably appear far too red (large values can,
however, be useful). The moral is, start small and then increase the tint color value a little at a time until the desired
effect is achieved. Also, don't forget to experiment with adjusting the moBrightenTint
parameter value in combination with the mouseOverBrighten parameter value.
The value for this parameter must
be a RGB value in hexadecimal format. For instance, the color red would be "FF0000",
and a medium gray would be "888888".
|
|
mouseDownBrighten
The mouseDownBrighten parameter is used whenever buttonBorders are not enabled
for the mouseDown button bar. If buttonBorders are specified for the mouseDown button bar (i.e.,
buttonBorders is assigned a value of "all" or "other"), then the
mouseDownBrighten parameter is ignored. See the mdBrightenAll for information
regarding overriding this behavior.
If the value of this parameter is greater than
zero, then the "brightness" of the mouseDown button bar will be increased by the specified
percentage.
If the value of this parameter is less than
zero, then the "brightness" of the mouseDown button bar will be decreased by the specified
percentage.
If a value for this parameter is not specified, then the brightness of the mouseDown button bar
will default to "35" if there is no mouseDown button bar image, or the brightness
will remain unchanged if a mouseDown button bar was specified.
Note that the value for this parameter may be less than "-100" or greater than "100", but
a point will be reached (depending on the colors being brightened) when decreasing or increasing the parameter
value will have no effect.
|
|
mdBrightenTint
This parameter is a color that is used to"tint" the mouseDown button bar when it is
"brightened" (see also the related mouseDownBrighten and
mdBrightenAll parameters).
For instance, if you want to give all of the buttons in
the mouseDown button bar a reddish tint, then you might specify the tint color:
|
<PARAM NAME="mdBrightenTint" VALUE="330000">
|
It is important to note that in order to tint the button bar, the mouseDownBrighten parameter must be assigned
a value other than zero (the value can be positive or negative).
Also, note that tinting is an additive process. This means that if you use a bright tint color, then the original
colors in the button bar will be brightened. It might be necessary to specify a negative value for
the mouseDownBrighten parameter in order to prevent the button bar from having a "washed out" appearance.
The tinting process is performed internally by adding the RGB values of the tint color to the RGB values of each pixel
in the mouseDown button bar image. The resulting image is then "brightened" by the percentage specified
by the mouseDownBrighten parameter.
For instance, suppose that the mouseDown button bar is a solid red color
("ff0000") and a green tint value is specified ("00ff00").
In this case the resulting mouseDown button bar color would be yellow
("ff0000" + "00ff00" = "ffff00").
This resulting yellow would then be "brightened" by the percentage specified by the
mouseDownBrighten parameter.
Usually a small tint value will yield the best results. For instance, a red only tint value
of "180000" will appear nearly black on it's own, but when added to the colors in
the button image will result in the button image having a reddish tint. If a larger red value was used,
for instance "ff0000", the button would probably appear far too red (large values can,
however, be useful). The moral is, start small and then increase the tint color value a little at a time until the desired
effect is achieved. Also, don't forget to experiment with adjusting the mdBrightenTint
parameter value in combination with the mouseDownBrighten parameter value.
The value for this parameter must
be a RGB value in hexadecimal format. For instance, the color red would be "FF0000",
and a medium gray would be "888888".
|
|
mdBrightenAll
In situations where buttonBorders are specified for the mouseDown
button bar buttons, then normally the mouseDownBrighten and
mdBrightenTint parameters are ignored.
If you would like the mouseDown buttons to be brightened (and optionally tinted) in all
situations, then you will need to set the mdBrightenAll parameter to true.
If a value is not specified for this parameter, then the parameter's value defaults to false.
|
|
drawGrayBase
This parameter controls if the "base"
button bar is converted to a grayscale image, or if it is drawn in the user
specified colors.
The reason that you would want to use a grayscale
base button bar is to accentuate the difference between the base state and other
button states. If the base button bar is drawn in grays, then when the mouse
moves over a button, the button will be drawn in color.
If
drawGrayBase is set to "true" then the applet will draw a grayscale
base button bar. If drawGrayBase is set to "false" then the applet
will display the base button bar in the colors specified for the bar.
If no value is specified for this parameter, then the parameter value defaults
to "true". |
|
buttonsDisabledDim
When a button is disabled, the applet will "dim"
or "darken" the button on the button bar by the percentage given by
this parameter.
Note that this applet will only disabled a button if
the URL for the button (the buttonXXURL parameter) has
been entered incorrectly, and if the disableBadURL
parameter has been set to "true".
If the value for this
parameter is greater than zero, then the grayscale base bar is "brightened"
by the specified percentage. If the value is less than zero, then the grayscale
base bar is darkened by the specified percentage.
The value for this
parameter must be between "-100" (brightest) and "100"
(darkest) percent.
If no value is specified for this parameter, then
its value defaults to "25". |
|
grayBarBrighten
In the case where drawGrayBase
is "true" (the default value), then the applet will create a grayscale
version of the button bar for use as the "base" button bar image. The
grayBarBrighten parameter is used in creating this grayscale base bar.
If the value for this parameter is greater than zero, then the grayscale base
bar is "brightened" by the specified percentage. If the value is less
than zero, then the grayscale base bar is darkened by the specified percentage.
Note that only color values are processed (using a weighted algorithm)
-- gray values are not brightened or darkened.
The value for
this parameter must be between "-100" and "100" percent.
If
no value is specified for this parameter, then its value defaults to "0". |
|
embossBase
This applet has the capability of performing a
basic form of embossing on a button bar. For best results, there should be a
fairly high degree of contrast between the fontColor
of the button text and the color of the button bar (or the
color of the button bar's texture, if used). Also, the
effect looks best if the button bar is rendered in shades of gray (see the
drawGrayBase parameter).
If embossing is
enabled, then the embossAngle,
embossContrast, and the
embossBrightness parameters control how the
embossing is performed on the button bar.
To enable embossing for the
base button bar, set this parameter to "true". If the value of this
parameter is set to "false", or if no value for the parameter is
specified, then embossing will not be performed for the base button bar. |
|
embossMouseOver
This applet has the capability of performing a
basic form of embossing on a button bar. For best results, there should be a
fairly high degree of contrast between the fontColor
of the button text and the color of the button bar (or the
color of the button bar's texture, if used). Also, the
effect looks best if the button bar is rendered in shades of gray.
If
embossing is enabled, then the embossAngle,
embossContrast, and the
embossBrightness parameters control how the
embossing is performed on the button bar.
This parameter determines if
embossing is performed on the button image that is displayed when the mouse
moves within a button's boundaries.
To enable embossing for the
mouseOver button bar, set this parameter to "true". If the value of
this parameter is set to "false", or if no value for the parameter is
specified, then embossing will not be performed for the mouseOver button bar. |
|
embossMouseDown
This applet has the capability of performing a
basic form of embossing on a button bar. For best results, there should be a
fairly high degree of contrast between the fontColor
of the button text and the color of the button bar (or the
color of the button bar's texture, if used). Also, the
effect looks best if the button bar is rendered in shades of gray.
If
embossing is enabled, then the embossAngle,
embossContrast, and the
embossBrightness parameters control how the
embossing is performed on the button bar.
This parameter determines if
embossing is performed on the button image that is displayed when the mouse is
clicked when within a button's boundaries.
To enable embossing for the
mouseDown button bar, set this parameter to "true". If the value of
this parameter is set to "false", or if no value for the parameter is
specified, then embossing will not be performed for the mouseDown button bar. |
|
embossAngle
The emboss angle is the angle at which a
simulated ray of light hits the button bar when creating an embossed image
effect.
The angle specified must be a multiple of 45 degrees (0, 45,
90, 135, 180, 225, 360).
This parameter is used only if embossing is
being performed for one or more button bars (see the embossBase,
embossMouseOver, and embossMouseDown
parameters).
If no value is specified for this parameter, then its
value defaults to"45" degrees. |
|
embossContrast
If the buttons for one or more button states are
embossed (see the embossBase,
embossMouseOver, and embossMouseDown
parameters), then this parameter controls the degree of contrast between the
button text color and the emboss highlight color.
Depending upon the
colors selected for the button text and the button background, the emboss
contrast setting will produce a recessed embossed appearance, or a raised
embossed appearance. Altering the sign of the contrast will produce the opposite
effect. For instance, if you specify a value of 15 and the letters look raised
on the button, then a value of -15 will cause the letters to look recessed.
The
value for this parameter can be any positive or negative integer, though values
between -30 and 30 will work best.
This parameter is used only if
embossing is being performed for one or more button bars.
If no value
is specified for this parameter, then its value will default to "10". |
|
embossBrightness
If the buttons for one or more button states are
embossed (see the embossBase,
embossMouseOver, and embossMouseDown
parameters), then this parameter controls the brightness of the embossed image.
A
value of 100 for this parameter is normal brightness. Any value over 100 will
increase the brightness of the embossed image, and any value less than 100 will
decrease the brightness of the embossed image (i.e., the image will be
darkened).
This parameter is used only if embossing is being performed
for one or more button bars.
If no value is specified for this
parameter, then its value will default to "100". |
|
disableBadURL
If a badly formed URL is set for a button (see
the buttonXXURL parameter), the applet will
dim the button.
In some situations
it may be desirable to have the button enabled, even though the entered URL for
the button is not valid. For instance, you might want to create a demonstration
web page that allows the user to click the buttons on the page, but does not
cause a new page to be loaded when a button is clicked. In this case, you can
omit the buttonXXURL tag for each button and set the disableBadURL
parameter to "false".
The value for this parameter can be
either "true" or "false". If a parameter value is not
specified, the the value defaults to "true". |
|
mouseEnterAudio
This optional parameter is used to specify the
file name of an AU audio clip file that will be played each time that the mouse
is moved within a button's boundaries.
Due to applet security
restrictions, the audio clip path is based starting with the directory where the
Java code is located (as opposed to starting with the directory where
the HTML page is located).
Note that the applet does not
support WAV or other audio file formats. There are a number of utilities
available that can be used to convert audio files to AU format. |
|
mouseClickAudio
This optional parameter is used to specify the
file name of an AU audio clip file that will be played each time that the mouse
button is pressed down (as opposed to releasing the mouse button) while it is
within a button's boundaries.
Due to applet security restrictions, the
audio clip path is based starting with the directory where the Java code
is located (as opposed to starting with the directory where the HTML page is
located).
Note that the applet does not support WAV or other
audio file formats. There are a number of utilities available that can be used to
convert audio files to AU format. |
|
buttonDownAudio
This optional parameter is used to specify the
file name of an AU audio clip file that will be played each time that the mouse
button is released after being pressed down within a button's boundaries. (The
parameter is called buttonDownAudio because the audio file is played
when the button has been activated, or in other words, has been cycled through
the "down" state.)
Due to applet security restrictions, the
audio clip path is based starting with the directory where the Java code
is located (as opposed to starting with the directory where the HTML page is
located).
Note that the applet does not support WAV or other
audio file formats. There are a number of utilities available that can be used to
convert audio files to AU format. |
|
buttonXXStart
The position of each button on your button bar is
defined by the buttonXXStart and the buttonXXSize
parameters.
Each button bar button is uniquely identified by the "XX"
portion of the parameter name. For instance, if you have three buttons on the
button bar, the parameter name for the button 1 starting position would be "button1Start",
the button 2 starting position parameter name would be "button2Start",
and button 3 starting position parameter name would be "button3Start".
One buttonXXStart parameter is required for each and every button that
you wish to define on the button bar. (Note that the XX portion of the buttonXXStart
parameter is always replaced with a number -- you should never
have a parameter literally called "buttonXXStart").
The start
location specified by the buttonXXStart parameter corresponds to the
location of the left edge (in the case of horizontal button bars) or top edge
(in the case of vertical button bars) of the button being defined. For instance,
suppose that there are three buttons on a horizontal button bar. Each button is
20 pixels wide and the buttons are arranged edge-to-edge. The value for the
button1Start parameter would be "0" (the left-most edge of the button
bar), button2Start would be "20" ( = 0 + 20), and button3Start would
be "40" ( = 20 + 20).
Remember that the buttonXXStart
parameter tells the applet what location on the button bar (measured from the
left or top edge) that the button begins. |
|
buttonXXSize
The position of each button on your button bar is
defined by the buttonXXSize and the buttonXXStart
parameters.
Each button bar button is uniquely identified by the "XX"
portion of the parameter name. For instance, if you have three buttons on the
button bar, the button 1 size parameter name would be "button1Size",
the button 2 size parameter name would be "button2Size", and the
button 3 size parameter name would be "button3Size". One buttonXXSize
parameter is required for each and every button that you wish to define on the
button bar. (Note that the XX portion of the buttonXXSize parameter is
always replaced with a number -- you should never have a
parameter literally called "buttonXXSize").
The button size
specified by the buttonXXSize parameter corresponds to the width (in the
case of horizontal button bars) or height (in the case of vertical button bars)
of the button being defined. For instance, suppose that there are three buttons
on a horizontal button bar. Each button is 20 pixels wide and the buttons are
arranged edge-to-edge. The value for the button1Size, button2Size, and
button3Size parameters would all be "20".
Remember that the
buttonXXSize parameter tells the applet how many pixels the button
extends from the value of the buttonXXStart parameter. |
|
buttonXXURL
Whenever a button on the button bar is clicked,
one or more URLs specified as the value of the buttonXXURL parameter are loaded
(see also the buttonXXTarget parameter).
A single URL or multiple URLs are assigned to a button by a parameter that is named
by replacing the
"XX" portion of the buttonXXURL parameter name with the button
number. For instance, the URL value for button 1 will have a parameter name of "button1URL",
the URL value for button 2 will have a parameter name of "button2URL", etc.
To assign a single URL to a button, simply specify the URL as the parameter value. For instance,
to assign the URL for the Modern Minds site to button 1 on a button bar, the parameter would be:
|
<PARAM NAME="button1URL" VALUE="http://www.modernminds.com">
|
To assign multiple URLs to a button, separate each URL with at least one space character. Note
that you will need to use multiple targets if you assign multiple URLs to a button
(see the buttonXXTarget parameter). An example of a button that has
multiple URLs assigned to it is:
|
<PARAM NAME="button1URL" VALUE="http://www.modernminds.com SiteList.html http://www.gamelan.com">
|
The value of
the buttonXXURL parameter can be any valid URL. This means that the URL can be a complete
URL as for instance,
|
<PARAM NAME="button1URL" VALUE="http://www.modernminds.com">
|
or the URL can be a relative URL like:
|
<PARAM NAME="button1URL" VALUE="Home.html">
|
If a relative URL is used, then the URL is relative to the directory that contains the HTML page
in which the applet is embedded.
Note that you can also use the "mailto" option to launch a user's mail
client. For example:
|
<PARAM NAME="button1URL" VALUE="mailto:comments@modernminds.com">
|
(Make sure that you do not use the buttonXXTarget
parameter if you are using "mailto".)
If a button position has been defined using a buttonXXStart
and a buttonXXSize parameter, but no buttonXXURL
parameter is defined, or if a badly formed URL is entered as the value of the
buttonXXURL parameter, then the button will be disabled (for information
about disabled buttons, see the buttonsDisabled,
buttonsDisabledDim, and
disableBadURL parameters).
Note that the XX
portion of the buttonXXURL parameter is always replaced with a
number -- you should never have a parameter literally called "buttonXXURL".
|
|
buttonXXTarget
The buttonXXTarget parameter defines the frame (or frames)
that the URL (or URLs) specified by the
buttonXXURL parameter will be loaded into when the button is clicked.
The value of the buttonXXTarget parameter can be any valid
target frame name or symbol (some browsers will open a new browser window if the
target name does not exist).
Some special symbolic values are (warning:
these values might not work for every browser):
_blank
Always load this link into a new, unnamed window
_self
Always
load this link over the current page
_parent
Always load this link
over the parent page (becomes self if there was no parent)
_top
Always
load this link at the top level (becomes self if current page is at the top)
|
If a single target is entered as the value of the buttonXXTarget parameter,
then whenever a button on the button bar is clicked the URL specified as the value
of the buttonXXURL parameter will be loaded in the frame specified
by the buttonXXTarget parameter. If the buttonXXTarget parameter is not specified, then the
URL is loaded into the current frame.
If multiple URLs are specified as the value of the buttonXXURL
parameter, then multiple target frames should be specified for the value of the buttonXXTarget
parameter (if the buttonXXTarget parameter is omitted or only one target is specified,
then all the URLs will load into a single target frame one after another).
To assign target frames for multiple URLs, separate each target name with at least one space
character. For instance, if the "button1URL" is defined as:
|
<PARAM NAME="button1URL" VALUE="http://www.modernminds.com SiteList.html http://www.gamelan.com">
|
then the corresponding "button1Target" might be defined as:
|
<PARAM NAME="button1Target" VALUE="_blank ContentFrame JavaFrame">
|
To omit a target frame in a list (for instance, if you are using a "mailto:" as a URL),
you can use a "-" (a dash) character at the appropriate position. For example:
<PARAM NAME="button1URL" VALUE="mailto:info@modernminds.com SiteList.html http://www.gamelan.com">
<PARAM NAME="button1Target" VALUE="- Frame1 Frame2">
|
A target frame is assigned to a
button's URL by a parameter whose name is formed by replacing the "XX"
portion of the buttonXXTarget parameter name with the button number. For
instance, the target frame for the button 1 URL will have a parameter name of "button1Target",
the target frame for the button 2 URL will have a parameter name of "button2Target",
etc.
Note that the XX portion of the buttonXXTarget parameter is
always replaced with a number -- you should never have a
parameter literally called "buttonXXTarget"
|
|
buttonXXDesc
Whenever the mouse is moved within a button's
boundaries, a line of text can be displayed on the browser's status line to give
the user a description of the button's purpose or function. The text is cleared
from the status line when the mouse is moved outside of the button's boundaries.
A
line of text is assigned to a button by a parameter whose name is formed by
replacing the "XX" portion of the buttonXXDesc parameter name
with the button number. For instance, the descriptive text for button 1 will
have a parameter name of "button1Desc", the descriptive text for
button 2 will have a parameter name of "button2Desc", etc.
If
this parameter is not specified for a button, then no text will be displayed on
the status line when the mouse is moved within the button's boundaries. |
|
buttonXXText
This parameter assigns base state button text for
the button identified by "XX" portion of the buttonXXText
parameter name. The base state is the state a button is in when the mouse is not
within the button's boundaries and the button is not disabled.
If the parameter name, for example, is "button1Text" and the parameter
value is "Home", then the first button on the button bar will be
labeled with the text "Home".
This parameter is required
for each button that will appear on the button bar. |
|
buttonXXTextOver
This parameter assigns the "mouseOver"
state button text for the button identified by "XX" portion of the
buttonXXText parameter name. The mouseOver state is the state a button
is in when the mouse is moved within the button's boundaries and the button is
not disabled.
If the parameter name, for
example, is "button1TextOver" and the parameter value is "Go Home",
then when the mouse is moved over the first button on the button bar the button
will display the text "Go Home".
If a value for this
parameter is not specified, then the button will display the text assigned by
the buttonXXText parameter when the mouse is moved
within a button's boundaries. |
|
buttonXXTextDown
This parameter assigns the "mouseDown"
state button text for the button identified by "XX" portion of the
buttonXXText parameter name. The mouseDown state is the state a button
is in when the mouse is clicked within the button's boundaries and the button is
not disabled.
If the parameter name, for
example, is "button1TextDown" and the parameter value is "Go!",
then when the mouse is clicked on the first button on the button bar the button
will display the text "Go!".
If a value for this parameter is
not specified, then the button will display the text assigned by the
buttonXXTextOver parameter when the mouse is
clicked on a button. |
|
buttonXXColor
This parameter is used to override the button's
background color for a single button.
For
example, if the parameter name is "button1Color" and the parameter
value is "00FF00" (blue), then the first button on the button bar will
have a blue background, regardless of what the default background
color is for the button bar.
The value for this
parameter must be a RGB value in hexadecimal format. For instance, the color red
would be "FF0000", and a medium gray would be "888888".
If
a value for this parameter is not specified, then the button's background color
will default to the value specified by the color
parameter. |
|
buttonXXAlign
This parameter is used to override the
alignment of a button's text within the button.
For
example, if the parameter name is "button1Align" and the parameter
value is "left", then the text for the first button on the button bar
will be aligned to the left side of the button, regardless of what the default
alignment is for button bar text.
If a value for this parameter is not
specified, then the button's text alignment will default to the value specified
by the align parameter. |
|
buttonXXFont
This parameter is used to override the
font used to draw the button's text.
For example,
if the parameter name is "button1Font" and the parameter value is "Courier",
then the text for the first button on the button bar will be drawn with the
Courier font, regardless of what the default font is for button bar text.
If
a value for this parameter is not specified, then the button's text font will
default to the value specified by the font parameter. |
|
buttonXXFontSize
This parameter is used to override the
font size used to draw the button's text.
For
example, if the parameter name is "button1FontSize" and the parameter
value is "24", then the text for the first button on the button bar
will be drawn with a 24 point font size, regardless of what the default font
size is for button bar text.
If a value for this parameter is not
specified, then the font size used to draw the button's text will default to the
value specified by the fontSize parameter. |
|
buttonXXFontStyle
This parameter is used to override the
font style used to draw the button's text.
For
example, if the parameter name is "button1FontStyle" and the parameter
value is "bold", then the text for the first button on the button bar
will be drawn with a bold font style, regardless of what the default font style
is for button bar text.
If a value for this parameter is not specified,
then the font style used to draw the button's text will default to the value
specified by the fontStyle parameter. |
|
buttonXXFontColor
This parameter is used to override the
font color used to draw the button's text.
For
example, if the parameter name is "button1FontColor" and the parameter
value is "0000FF" (blue), then the text for the first button on the
button bar will be drawn in blue, regardless of what the default font color is
for button bar text.
The value for this parameter must be a RGB value
in hexadecimal format. For instance, the color red would be "FF0000",
and a medium gray would be "888888".
If a value for this
parameter is not specified, then the font color used to draw the button's text
will default to the value specified by the fontColor
parameter. |
|
buttonXXFontColorOver
This parameter is used to override the
font color used to draw a button's text when the
mouse is moved within the button's boundaries.
For example, if the
parameter name is "button1FontColorOver" and the parameter value is "00FF00"
(green), then the text for the first button on the button bar will be drawn in
green whenever the mouse is moved over the button, regardless of what the
default "mouseOver" font color is for button bar text.
The
value for this parameter must be a RGB value in hexadecimal format. For
instance, the color red would be "FF0000", and a medium gray would be "888888".
If
a value for this parameter is not specified, then the font color used to draw
the button's text when the mouse is moved within the button's boundaries will
default to the value specified by the fontColorOver
parameter. |
|
buttonXXFontColorDown
This parameter is used to override the
font color used to draw a button's text when the
mouse is clicked on the button.
For example, if the parameter name is "button1FontColorDown"
and the parameter value is "FF0000" (red), then the text for the first
button on the button bar will be drawn in red whenever the mouse is clicked on
the button, regardless of what the default "mouseDown" font color is
for button bar text.
The value for this parameter must be a RGB value
in hexadecimal format. For instance, the color red would be "FF0000",
and a medium gray would be "888888".
If a value for this
parameter is not specified, then the font color used to draw the button's text
when the mouse is clicked on the button will default to the value specified by
the fontColorDown parameter. |
|
