Top  | Previous | Next

Bar Chart

charts_BarChart

Description

The Bar Chart is a very easy-to-use chart that provides familiar bar charts. It also can be configured to display other kinds of category charts. A category chart is a chart whose X-values are categories (strings) rather than numeric values (numbers, dates).

 

Like most chart components (other than the Easy Chart), the Data property drives the chart. The first column in the Data dataset defines the names of the categories. The rest of the columns define the values for each of the series (if there is more than one series per category), and thus should be numeric. Note - if your data is 'turned on its side', meaning that the columns define the categories and rows define the series, then set the Extract Order to "By Column".

 

Extract Order Example

The following two charts demonstrate the effects of the extract order property on the given dataset

 

Label (String)

North Area (Integer)

South Area (integer)

Jan

15

35

Feb

21

36

Mar

17

23

Apr

11

39

May

16

32

 

charts_BarChart_extractorder

 

Properties

Appearance

Chart Title

An optional title that will appear at the top of the chart.

Scripting name

title

Data type

String

Chart Type

Controls how the bar chart is displayed.

Scripting name

rendererType

Data type

int

Values

0

Bar

1

3D Bars

2

Stacked Bars

3

3D Stacked Bars

4

Layered

5

Area

Plot Background

The background color for the plot.

Scripting name

plotBackground

Data type

Color

Series Colors

The sequence of colors used for series in the bar chart.

Scripting name

seriesColors

Data type

Color[]

Legend?

 

Scripting name

legend

Data type

boolean

Labels?

Always display labels?

Scripting name

labels

Data type

boolean

Gradient bars?

If true, bars will be painted with a gradient 'shine'.

Scripting name

gradient

Data type

boolean

Shadows?

If true, bars will have a drop-shadow beneath them.

Scripting name

shadows

Data type

boolean

Foreground Transparency

The transparency of the pie (useful for 3D pies)

Scripting name

foregroundAlpha

Data type

float

Vertical

Sets the orientation of the chart to vertical (true) or horizontal(false)

Scripting name

vertical

Data type

boolean

Category Margin

The margin between categories as a fraction of the total space

Scripting name

categoryMargin

Data type

double

Item Margin

The margin between bars in a category as a fraction

Scripting name

itemMargin

Data type

double

Axes

Value Axis Label

The label for the value axis

Scripting name

valueLabel

Data type

String

Category Axis Label

The label for the category axis

Scripting name

categoryLabel

Data type

String

Value Axis Auto-Range

If true, the value axis range will be determined automatically. If false, the specified upper and lower bounds will be used.

Scripting name

valAxisAutoRange

Data type

boolean

Value Axis Lower Bound

The lower bound of the value axis. Used only when auto-range is false.

Scripting name

valAxisLowerBound

Data type

double

Value Axis Upper Bound

The upper bound of the value axis. Used only when auto-range is false.

Scripting name

valAxisUpperBound

Data type

double

Category Axis Label Angle

The angle for the value axis' labels.

Scripting name

catAxisLabelPosition

Data type

int

Values

0

Standard

1

Down 45

2

Down 90

3

Up 45

4

Up 90

Title Font

The font for the chart's title.

Scripting name

titleFont

Data type

Font

Legend Font

The font for the legend items.

Scripting name

legendFont

Data type

Font

Bar Label Font

The font for the bar labels.

Scripting name

barLabelFont

Data type

Font

Bar Label Offset

The offset between the bar and the bar label.

Scripting name

barLabelOffset

Data type

double

Flags

expert

Value Axis Label Font

The font for the value axis label.

Scripting name

valAxisLabelFont

Data type

Font

Category Axis Label Font

The font for the category axis label.

Scripting name

catAxisLabelFont

Data type

Font

Value Axis Tick Font

The font for the value axis' ticks.

Scripting name

valAxisTickFont

Data type

Font

Category Axis Tick Font

The font for the category axis' ticks.

Scripting name

catAxisTickFont

Data type

Font

Bar Label Color

The color for the bar labels.

Scripting name

barLabelColor

Data type

Color

Value Axis Label Color

The color for the value axis label.

Scripting name

valAxisLabelColor

Data type

Color

Category Axis Label Color

The color for the category axis label.

Scripting name

catAxisLabelColor

Data type

Color

Value Axis Tick Color

The color for the value axis' ticks.

Scripting name

valAxisTickColor

Data type

Color

Category Axis Tick Color

The color for the category axis' ticks.

Scripting name

catAxisTickColor

Data type

Color

Value Axis Upper Margin

The upper margin, as a percentage, of the value axis. Only used when auto-range is true.

Scripting name

valAxisUpperMargin

Data type

double

Category Axis Upper Margin

The upper margin, as a percentage, of the category axis.

Scripting name

catAxisUpperMargin

Data type

double

Category Axis Lower Margin

The lower margin, as a percentage, of the category axis.

Scripting name

catAxisLowerMargin

Data type

double

Behavior

Tooltips?

 

Scripting name

tooltips

Data type

boolean

Common

Name

The name of this component.

Scripting name

name

Data type

String

Flags

bindable

Visible

If disabled, the component will be hidden.

Scripting name

visible

Data type

boolean

Flags

bindable

Border

The border surrounding this component. NOTE that the border is unaffected by rotation.

Scripting name

border

Data type

Border

Mouseover Text

The text that is displayed in the tooltip which pops up on mouseover of this component.

Scripting name

toolTipText

Data type

String

Cursor

The mouse cursor to use when hovering over this component.

Scripting name

cursorCode

Data type

int

Flags

expert

Values

0

Default

1

Crosshair

2

Text

3

Wait

12

Hand

13

Move

4

SW Resize

5

SE Resize

6

NW Resize

7

NE Resize

8

N Resize

9

S Resize

10

W Resize

11

E Resize

Data

Data

The data driving the chart.

Scripting name

data

Data type

Dataset

Flags

bindable

Data Quality

The data quality code for any tag bindings on this component.

Scripting name

dataQuality

Data type

int

Flags

bindable | expert

Extract Order

Controls whether the first row defines the categories or the series

Scripting name

extractOrder

Data type

int

Values

0

By Column

1

By Row

Scripting

Events

The following event sets are fired by this component. See Component Event Handlers to learn more.

•mouse
•mouseMotion
•propertyChange

 

Scripting Functions

This component has no special scripting functions.