Metaview Applet Parameters

Metaview Applet Parameter Reference

The following parameters may be specified for the Metaview applet.For information on how to specify these parameters, see Specifying Applet Parameters Using the ODS PARAMETERS= Statement.

BACKGROUNDCOLOR=color

specifies the background for the applet as an RGB color in hexadecimal. White is 0xffffff. Red is 0xff0000. If not specified, the background color is 0xd3d3d3 (gray).

Note: This parameter changes only the color of the applet. You can use the CBACK= graphics option in the GOPTIONS statement to set the background color of the graph.

DATATIPHIGHLIGHTCOLOR=color

specifies an RGB color in hexadecimal that is displayed as the outline of the graph element that is displaying its data tip information. The default color is red. This parameter is valid only if the DATATIPSTYLE parameter is set to the value HIGHLIGHT.

DATATIPSTYLE= HIGHLIGHT | STICK | STICK_FIXED

specifies the style of the data tip pop-up window. Values can be:

HIGHLIGHT

causes the data tip to appear above the segment with no connecting line. The border of the graph element is highlighted.

STICK

connects the data tip pop-up window to the graph element with a line. The pop-up window is positioned over the cursor. As long as the cursor remains in the element, moving the cursor moves the pop-up window and the connecting line.

STICK_FIXED

connects a stationary data tip pop-up window to the graph element with a line drawn into the middle of the graph element.

DEFAULTTARGET=target-name

specifies where the browser will display drill-down URLs by default. The value of this parameter can be an HTML target such as _BLANK or the name of a window or frame in the Web presentation. The default value is _BLANK, which displays drill-down URLs in a new browser window. The value of the DEFAULTTARGET parameter is superseded by the optional drill-down tag TARGET.

LOGRESOURCES=TRUE | FALSE

specifying a value of TRUE logs tag/value pairs in the key definition file. The default value is FALSE. The tag value pairs are copied out of the key definition file and modified to create a resource file. The resource file is named MVAResources.properties, and it enables the Metaview applet text to be translated to another language. See also the RESOURCESFONTNAME parameter.

METACODES=codes-or-file-specification

identifies a text file that contains metagraphics codes, or it provides inline metagraphics codes. The file specification is an absolute or relative URL address.

METACODES1-METACODESn=codes-or-file-specification

identifies additional metacode specifications when you need to identify more than one file or more than one set of inline metagraphics codes.

METACODESLABEL=menu-labelMETACODES1LABEL-METACODESnLABEL=menu-label

names the text labels that are used to identify the graphs specified in the METACODES and METACODESn parameters. If specified, there should be as many METACODESLABEL parameters as there are METACODESn parameters. Always specify METACODESLABEL parameters sequentially (METACODESLABEL, METACODES1LABEL, METACODES2LABEL, and so on). The applet displays the labels in an embedded graph-selection control.

RESOURCESFONTNAME=font-name

specifies the name of the font family that is used to display the resource values in a user-defined resource file. This allows the Metaview applet, which is Java 1.02 compliant, to emulate the language translation capabilities of Java 1.2. The applet first tries to use the specified font-name, then it tries to use the SansSerif font, then it tries to use the Serif font, then it uses the first font that is returned by the Java.Awt.Toolkit. The first font that is found is the font that is used. See also the LOGRESOURCES parameter.

ZOOMCONTROLENABLED=TRUE | FALSE

displays the embedded zoom control under the graph. The default is TRUE. Specifying a value of FALSE suppresses the display of the zoom control.

Unless you choose to suppress it, the Metaview applet always displays a zoom control that allows a user to zoom in on and out of the image. To suppress the zoom control, specify ZOOMCONTROLENABLED=FALSE in the ODS statement, as follows:

ods html body=“ncpop.htm” 
parameters=(“DATATIPSTYLE”=“STICK” 
“ZOOMCONTROLENABLED”=“FALSE”);

ZOOMCONTROLMIN=minimum-percentage

specifies a new lower limit for the zoom feature. The default value is 25% of initial size. Valid values range from 1 to 99.

ZOOMCONTROLMAX=maximum-percentage

specifies a new upper limit for the zoom feature. The default value is 500% of initial size. Valid values range from 100 to 25000.

Specifying Applet Parameters Using the ODS PARAMETERS= Statement

You can control the initial appearance of your Web output and configure aspects of the applet's user interface by specifying applet parameters. The applet parameters are generally specified as follows in the PARAMETERS= option of the ODS statement.

ODS HTML BODY=HTML-output-file-specification

PARAMETERS=(
“parameter-name1”=“parameter-value1”...
“parameter-nameN”=“parameter-valueN”);

For example:

ods html body="ncpop.htm"
 parameters=("DATATIPSTYLE"="STICK"
 "ZOOMCONTROLENABLED"="FALSE");

You can specify any number of parameters in a single PARAMETERS= statement. The parameters can be specified in any order. Blank spaces separate multiple parameter specifications. You can also use multiple PARAMETERS= statements within a given ODS statement. The quotation marks and parentheses are required. Additional quotation marks are required in the specification of certain parameter values.