Metaview Applet Parameters

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 on page 477.

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).

DATATIPHIGHLIGHTCOLOR= color

• specifies a 6-digit hexadecimal RGB color 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. While 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.

HELPLOCATION= URL

• specifies a location for application-specific help that replaces the default help that is provided for the Metaview Applet. The default help location is the SAS web site.

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 identified with the RESOURCES parameter, which 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-METACODES n = 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-label

METACODES1LABEL-METACODES n LABEL= menu-label

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

PAGECONTROLENABLED=TRUE FALSE

• enables or disables the display of a scroll control in the Metaview Applet. The applet displays the control by default, when more than one graph is contained in the metacodes set. Specify FALSE to disable the scroll control.

RESOURCES= text-URL

• specifies the relative or absolute URL of an ASCII-formatted resources file. This file enables the translation of the English text that is provided in the Metaview Applet. The resource file is provided so that the Metaview Applet, which is Java 1.02 compliant, can provide translation capabilities that are similar to the resource files that are enabled in Java 1.2. Note that you do not have to specify the RESOURCES parameter if you provide a resource file with the name MVAResources.properties in the same directory as the HTML output file. The Metaview Applet looks for this file by default and uses it if it is found. Specifying a value for the RESOURCES parameter overrides this default applet behavior. For information on creating a resources file, see Specifying Non-English Resource Files and Fonts on page 474. See also the parameters LOGRESOURCES and RESOURCESFONTNAME.

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 parameters LOGRESOURCES and RESOURCES.

SLIDESHOWCONTROLENABLED=TRUE FALSE

• displays the embedded slide-show control when the current set of metagraphics codes contains more than one graph. The default is TRUE. Displaying the slide-show control allows you to start and stop a loop that displays each graph for a specified amount of time. You can change the amount of time that each graph is displayed. Specifying a value of FALSE prevents the display of the slide-show control.

ZOOMCONTROLENABLED=TRUE FALSE

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

ZOOMCONTROLMIN= minimum-percentage

• specifies a new lower limit for the zoom feature. The default value is 25 percent 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 percent 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 FILE= HTML-output-file-specification

• PARAMETERS=(

  • " parameter-name1 "=" parameter-value1 "...

  • " parameter-nameN "=" parameter-valueN ");

An example might look like this:

 ods html file="ncpop.htm"      parameters=("DATATIPSTYLE"="STICK"           "HELPLOCATION"="http://www.mysite.com/myjavametahelp.htm"           "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.