Region Parameters

Region definitions are used extensively throughout NetCharts applets in order to display titles, legends, data labels, etc. Regions are displayed as a rectangle box, with a given color and border type. Optionally, an image file can be specified which will be used in place of the region's background color. Regions are used throughout NetCharts as an optional background for labels.

The following region parameters are supported by one or more chart applets:

Background    = (Color, BorderType, BorderWidth, "Image URL", ImageScale);
HeaderBox     = (Color, BorderType, BorderWidth, "Image URL", ImageScale);
FooterBox     = (Color, BorderType, BorderWidth, "Image URL", ImageScale);
LeftTitleBox  = (Color, BorderType, BorderWidth, "Image URL", ImageScale);
RightTitleBox = (Color, BorderType, BorderWidth, "Image URL", ImageScale);
LegendBox     = (Color, BorderType, BorderWidth, "Image URL", ImageScale);
DwellBox      = (Color, BorderType, BorderWidth, "Image URL", ImageScale);
NoteBox       = (Color, BorderType, BorderWidth, "Image URL", ImageScale);
All of the attributes are optional and if they are not specified, default values will be used, depending on the specific parameter being defined.

The following attributes are supported:



Color The color of the region. If an image attribute is also defined, this value is ignored. See NFColor for a complete list of supported color names and value expressions.

BorderType The following border styles are supported:
	NONE    - No border
	BOX     - Simple Box outline
	SHADOW  - Shadow border
	RAISED  - Raised border
	RECESS  - Recessed border
When the BOX and SHADOW styles are specified, the border color will be black. When the RAISED and RECESS styles are specified, the border color will be chosen based on the region color.
BorderWidth This attribute defines the width of the border in pixels.

Image URL This attribute can be used to specify an image file to be used to fill the region. Any valid URL may be specified. If a relative URL is given, it will be interpreted based on the Document Base of the HTML document.

ImageScale Specifies how the image will be displayed in the region, with the following types supported:
TILE - (default) tiles or clips the image if not the same 
       size as the region.
SIZE - scales the image to the size of the region.

Example

In this example, four titles are defined, using different underlying regions.

Header        = ("This Is A Default Label");
HeaderBox     = (darkgreen, NONE);

Footer        = ("This Is A\nMulti-Line\nFooter", darkred);
FooterBox     = (white, SHADOW, 4);

LeftTitle     = ("Rotated Label", black,"TimesRoman", 16, 90);
LeftTitleBox  = (yellow, RAISED, 10);

RightTitle    = ("Large\nLabel", blue, "Courier", 30);
RightTitleBox = (white, BOX, 2, "flock.gif");