ThingWorx Extensibility > Extensions > Custom Charts > Bar Chart Widget Extension > Bar Chart Widget Extension Properties
Bar Chart Widget Extension Properties
The properties of Bar Chart widget follow:
Property Name
Description
Base Type
Default Value
Bindable? (Y/N)
Localizable? (Y/N)
SingleDataSource
Use a single data source for all series.
BOOLEAN
True
N
N
NumberOfSeries
Defined number of series in the chart. Can have up to eight series.
NUMBER
1
N
N
Data
Data source. This property is not displayed if SingleDataSeries is unchecked.
INFOTABLE
n/a
Y
N
ChartTitle
The title of the chart.
STRING
n/a
Y
Y
ShowAxisLabels
Display major axis labels.
BOOLEAN
True
N
N
X-AxisLabel
Text label for the x-axis.
STRING
X-Axis
N
Y
X-AxisField
The property that displays on the bottom of the x-axis on the chart.
MENUNAME
n/a
Y
N
LabelDataSource
This property displays a dropdown list of all datasources that are bound to the bar chart.
* 
It is only available for multi-series multi-data displays.
STRING
n/a
N
N
LabelField
This property displays a dropdown list of all fields in the datasource that was selected using the LabelDataSource property.
NOTE: This property is only available for multi-series multi-data displays. By using the LabelDataSource and LabelField properties, you can choose the data to be displayed from the datasource when the user hovers over each bar.
STRING
n/a
N
N
Y-AxisLabel
Text label for the y-axis.
STRING
Y Axis
N
Y
LabelAngle
Helps longer labels in the chart fit by setting them diagonally.
NUMBER
0
N
N
Duration (ms)
The length/speed of transitions when values change in the chart.
NUMBER
500
N
N
ChartBodyStyle
The overall style of the chart. The default is transparent.
STYLEDEFINITION
(transparent)
N
N
ChartTitleStyle
The style of the chart title (at the top).
STYLEDEFINITION
N
N
ChartTooltipStyle
Chart axes tooltip style.
STYLEDEFINITION
N
N
ChartAxisStyle
The style of the axis grid and outline.
STYLEDEFINITION
N
N
ChartTitleAlignment
The alignment for the title of the chart. Options: Left, Center, and Right.
STRING
Center
N
N
ShowLegend
Display or hide the legend for multiple series. The legend displays at the top of the chart. Chart and legend adjust to fit at runtime.
BOOLEAN
True
N
N
AutoScale
Automatically scale the chart to see all data on the y-axis.
BOOLEAN
True
N
N
XAxisIntervals
Preferred X-axis chart intervals (affects tick and grid).
STRING
One per row
N
N
Show X-AxisLabels
Displays the x-axis labels.
BOOLEAN
True
N
N
TruncateX-AxisLabels
The maximum number of characters to display before truncating with ellipses and showing the full label text in a tooltip. Default 0 disables the feature. A negative value will trim the number of characters specified from off the front of the label. A positive value will trim from the end of the label.
STRING
0
N
N
Show Y-AxisMinMax
Displays the y-axis min and max values (highest and lowest data points).
BOOLEAN
True
N
N
Y-AxisIntervals
Preferred y-axis intervals. Options: Auto and One-Per-Row.
STRING
Auto
N
N
TruncateY-AxisIntervals
The maximum number of characters to display before truncating with ellipses and showing the full label text in a tooltip. Default 0 disables the feature. A negative value will trim the number of characters specified from off the front of the label. A positive value will trim from the end of the label.
STRING
0
N
N
Y-AxisMinimum
The minimum range for the y-axis.
* 
This is a trim value, so if you have a value that is less than 0, the values will still display. If you have values greater than 0, the axis will start at 0.
NUMBER
0
Y
N
Y-AxisMaximum
The maximum range for the y-axis.
* 
The chart will not be truncated if the data points aren’t equal to the max value. For example, if you set this value at 100, and your highest data point is 80, there will be a space in the chart between 80 and 100.
NUMBER
100
Y
N
EnableHover
Displays tooltips with values when a user hovers over a bar in the chart.
* 
This property is available only for multi-series displays of a bar chart.
BOOLEAN
True
N
N
Margins
Additional label margin pixel values. This creates a buffer outside of the chart (top, left, bottom, right). This can be useful for displaying long values.
STRING
0,0,0,0
N
N
DataDisplay
This property is available only for single series displays of a bar chart.
You can select one of the following options:
• None: The values over each bar are not displayed.
• Hover: The value will be displayed when you hover over the bar.
• Show Values: Displays the value over each bar.
* 
For multi-series, only the hover option is available and EnableHover property is displayed.
STRING
None
N
N
DataField1
Series data field1.
MENUNAME
n/a
Y
N
DataLabel1
The label for data field1.
STRING
n/a
Y
Y
SeriesStyle
The style for series style1.
STYLEDEFINITION
n/a
N
N
ShowDataLoading
Display the data as it loads.
BOOLEAN
True
N
N
DoubleClicked
An event is fired when the chart is double-clicked.
n/a
Y
N
Z-index
The ordering for layering widgets.
NUMBER
10
N
N
Visible
Display the chart in run time.
BOOLEAN
True
Y
N
Was this helpful?