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 borderWhen 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. |
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");