There are four special attributes that can be used for customizing the applet window during downloading of an applet. (Note: The same applies to a JavaBeans component.) This section discusses:
When none of these tags are used, the default appearance of the applet window is as follows:
The Java brand mark is centered in the applet's space. There is a white glow (circle with hazy edge) encircling the Java brand. The rotating burst animation shows that activity is occuring. The progress bar is located below the bottom edge of the Java brand graphic to show the progress as the applet is downloaded.
Depending on the size of the applet's viewing area the default appearance will vary. The design of animation will scale to accomodate different "width-by-height" combinations.
When the mouse is moved over the applet's area during the loading period, the cursor changes to the normal hypertext cursor indicating that this element is an interactive part of the web page. Clicking/selecting anywhere within the Gray Box will spawn a new browser window pointing to the www.java.com web page.
image attribute allows you to replace the default
animation with a custom graphic.
The format with the standard
APPLET element is:
<PARAM name="image" value="my_image.gif">
APPLET Tags in Java Plug-in for how this would be mapped
OBJECT or the
If a custom graphic is specified, it should be the same size as the area of
the applet window. If these sizes do not match, the graphic will be placed in
the upper left corner of the area specified for applet. If it is larger than
the applet window, part of it will get chopped off. If it is smaller than the
applet window, white, or whatever color is specified for
will appear around it.
The image can be either a GIF or JPEG, and it should reside in the same directory
where other resources for the applet reside; i.e., if the applet uses the
attribute, then this image should be in the
Note: The image file should not be in a packaged jar file with other applet resources, since the image needs to be displayed while downloading resources.
The status bar of the browser will display "
Loading Java Applet ..."
when the mouse is pointed at the applet window.
boxmessage attribute you can customize the text displayed in
the status bar of the browser. This attribute will be in effect when
attribute is used. The format for using this with the
APPLET element is:
<PARAM name="boxmessage" value="<your custom message goes here>">
These attributes can be used to customize colors in the applet window.
These attributes will be in effect when the
attribute is used. Custom colors cannot be specified for the default appearance
of the applet viewing area.
By default the applet window background color is white.
can be used to specify a different background color. The format for use with
APPLET element is:
<PARAM name="boxbgcolor" value="<value>">
<value> may be:
bare integers in the range of
0-255that would render an opaque standard RGB (sRGB) color in the
Color(int r, int g, int b);
Examples of each item above:
By default the applet window foreground color is black.
boxfgcolor can be used to specify a different
foreground color. The color values are the same
as described above. The format for use with the standard
<PARAM name="boxfgcolor" value="<value>">
The order of precedence for these attributes is as follows:
1) If no parameters are provided, the default appearance
described above is used.
2) If a custom graphic is specified via the
image attribute, then
the custom graphic will appear as described above under
3) If custom text is provided via the
boxmessage attribute, then
custom text will be displayed as described above under
With any combination of
attributes, custom colors can always be provided via the
If an applet fails to load, the applet window will display error information. The applet window will have a single pixel border using white for the foreground color, and a small "broken" graphic will occupy the upper left corner. The user can right-mouse click over the applet window to get a popup menu with options to: