ChartDirector 7.0 (Perl Edition)

LinearMeter.addBar


Usage

addBar(startValue, endValue, color [, raisedEffect [, roundedCorners ]])

Description

Adds a bar to the meter.

This method adds an empty TextBox to the meter. It configures the textbox position, size and color so that it looks like a bar on the meter scale.

Arguments

ArgumentDefaultDescription
startValue(Mandatory)The start value of the bar.
endValue(Mandatory)The end value of the bar.
color(Mandatory)The color of the bar.
raisedEffect0The 3D border width. For positive values, the border will appear raised. For negative values, the border will appear depressed. A zero value means the border will appear flat. This argument can also be used to specify perlchartdir::glassEffect, perlchartdir::softLighting, perlchartdir::cylinderEffect or perlchartdir::flatBorder effects.
roundedCorners0The radius for the two corners at the end position of the bar.

Return Value

A TextBox object representing the bar. This may be used to fine-tune the appearance of the bar.