Each of WebShow's parameters is explained below, with reference to the clickable example code in the left frame: you can click a parameter from the example code to jump to its explanation, or simply read this page from top to toe. As you read, click the red references to other parameters to jump to them.
Most of WebShow's parameters have a default setting which is mentioned below. If the default setting is the option you'd like to use in your own implementation, you can leave that parameter out of your HTML code.
The 'Archive' attribute & 'CabBase' parameter
JAR (Java ARchive) and CAB (cabinet) files are archives containing Java class files in compressed form, making them easier to handle and quicker to download. Most modern browsers are able to read one or other of these formats, and the Archive attribute and CabBase parameter tell the browser the name of the archive file to open. The .JAR, .CAB and .CLASS files must all be in the same directory, and the CODEBASE= attribute is used in the normal way, if required, specifying the absolute or relative location of this directory. Older browsers that are unable to read either the JAR or the CAB file will instead read the loose CLASS files.
Applet Width & Height
WebShow will accept any dimensions for the applet. However, you should ensure that the dimensions are at least as large as any image being displayed (plus the width and/or height or any body-margins set in the page). Because WebShow has no horizontal scrollbar, long unbroken lines of text may need to be broken manually by adding <br> tags.
Copyright
This parameter must be included or the applet will not run, whether registered or unregistered. To prevent mistakes we recommend that you copy/paste it into your code from the Getting Started page: it is case-sensitive, single-spaced throughout and should appear on a single line. If there's a problem with this parameter, you'll see a status-bar message that reads "Copyright parameter missing or incorrect" which should lead you to the problem.
URL
The absolute or relative URL of an HTML page to be displayed when WebShow loads. This parameter must point to a file on the same server as the page containing the applet. If this parameter is missing, WebShow will display a blank page. Note that although you can display a plain-text page, WebShow will not know where the paragraph/line breaks should occur so the text will be formatted as a block. At the very least, a plain-text page should include <p> and/or <br> tags to mark the line-breaks.
ScrollFromTop
A yes or no parameter, with a default of yes. This parameter determines whether to scroll a newly-loaded page from the top of the WebShow control (default) or from the bottom. Leaving this parameter set to its default allows you to use the TopPosition parameter, below.
TopPosition
When the ScrollFromTop parameter (above) is set to 'yes', you can use the TopPosition parameter to specify how far from the top of the WebShow control the page is initially placed. By default, the value is 0, so the page is placed at the top of the control. Setting this to 100 (for example) places the top of the page 100 pixels below the top of the control. This gives the reader time to read the first few lines before they are scrolled out of view. (If ScrollFromTop is set to 'no', this parameter is ignored.)
ScrollDelay
Sets the speed at which pages are scrolled. The default is 30 and the minimum is 5. (Any lower value defaults to 5.) Lower values result in faster scrolling.
RepeatSpacing
Takes any positive or negative number (including 0), with a default of 10. WebShow scrolls the current page endlessly, and therefore there will be a 'join' between the end of the page and the beginning of its next iteration. This parameter sets how much vertical space should be placed at this gap, in pixels. If the page currently being displayed by WebShow includes a TOPMARGIN attribute in its <BODY> tag, the value of the TOPMARGIN will be added to this parameter. A good way to work (particularly if you will display multiple linked pages in WebShow) is to set this parameter to 0, and include a <BODY TOPMARGIN> in each page to be displayed.
PauseOnEnter
A simple yes or no parameter with a default of yes. By default, WebShow's scrolling will pause when the mouse enters, and resume when it exits. If you set this parameter to 'no', scrolling will continue regardless of mouse movement or clicks.
ButtonizeImageLinks
Another yes or no parameter, defaulting to 'no'. This parameter only has an effect if the page displayed by WebShow includes inline images (<IMG> tags) which act as links (ie. they're enclosed in <A> tags). When set to 'yes', the image will gain a reactive 3D border when the mouse moves over it, and will drop down by a pixel when clicked. (Note that if the IMG tag contains BORDER=0, the 3D border won't be shown, but the drop-down will still occur.)
InsetImageBorders
Yet another yes or no parameter, again defaulting to 'no', and also applying to inline images. If set to 'yes', any inline image with a border (whether a link or not) will have an inset 3D border created using the background color of the page. If set to 'no', a standard border will be drawn.
DefaultTarget
When a link (<A> tag) in the displayed page is clicked, WebShow looks for a TARGET attribute in the <A> tag. If no TARGET attribute exists, WebShow uses the target-name specified in this parameter. (If this parameter doesn't exist, "_self" is used by default.) The <A> tag's TARGET attribute and this DefaultTarget parameter can use any valid frame or window name, including HTML names such as _top and _new. They can also use _webshow. This tells WebShow to try to open and display the page itself.
FallbackTarget
As mentioned above, links and the DefaultTarget parameter can target _webshow rather than a 'real' frame or window name. In this case, WebShow will try to open and display the linked page itself. It can only do this if the page resides on the same server as the page containing the WebShow applet. If WebShow fails to open the page itself, it will pass the URL to the browser, along with a target name specified in this FallbackTarget parameter. (If this parameter isn't included, "_self" will be used.) Note that this parameter cannot specify _webshow as a target name (since WebShow has already failed to open the page); using _webshow here will result in the default _self being used.
LoadBgColor
When WebShow is loading a page to be displayed, it displays a short message to indicate that something is happening. This parameter and those below determine how this message is formatted. The LoadBgColor parameter sets the background color of the WebShow contol, with a default of 000000 (black).
LoadTextColor
Similar to the parameter above, this sets the text-color of the displayed message. The default is 00FF00 (lime).
LoadText1, LoadText2
WebShow displays up to two lines of non-wrapping text while a page is being loaded. These two parameters let you specify what text is shown. The defaults are:
LoadText1: Loading page.You can override these default lines by including the appropriate parameters with your own choice of text. Note that the lines displayed do not wrap, so they must be short enough to be visible within the width of the applet. If you only want to display a single line, set the other parameter to an empty string (eg. value="").
LoadText2: Please wait...
ShowLoad
This parameter only ever has a value of 'no'. What matters to WebShow is whether the parameter exists or not. If this parameter is included, WebShow will not display the 'loading text' message when the first page is being loaded. However, it will display them for subsequent pages. If this parameter isn't included, the 'loading text' message will also be shown as the applet starts and loads the initial page (specified in the URL parameter). Unless you experience problems with loading pages, you should leave this parameter out of your page.
.