javafx.scene.chart

Class BarChart<X,Y>

java.lang.Object

Region

javafx.scene.chart.Chart

javafx.scene.chart.XYChart<X,Y>

javafx.scene.chart.BarChart<X,Y>

public class BarChart<X,Y>
extends XYChart<X,Y>

A chart that plots bars indicating data values for a category. The bars can be vertical or horizontal depending on which axis is a category axis.

Since:

JavaFX 2.0

Property Summary

Type	Property and Description
DoubleProperty	barGap The gap to leave between bars in the same category
DoubleProperty	categoryGap The gap to leave between bars in separate categories

Properties inherited from class javafx.scene.chart.XYChart

alternativeColumnFillVisibleProperty, alternativeRowFillVisibleProperty, dataProperty, horizontalGridLinesVisibleProperty, horizontalZeroLineVisibleProperty, verticalGridLinesVisibleProperty, verticalZeroLineVisibleProperty

Properties inherited from class javafx.scene.chart.Chart

animatedProperty, legendProperty, legendSideProperty, legendVisibleProperty, titleProperty, titleSideProperty

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	BarChart.StyleableProperties

Nested classes/interfaces inherited from class javafx.scene.chart.XYChart

XYChart.Data<X,Y>, XYChart.Series<X,Y>

Field Summary

Fields

Modifier and Type	Field and Description
private DoubleProperty	barGap The gap to leave between bars in the same category
private double	bottomPos
private CategoryAxis	categoryAxis
private DoubleProperty	categoryGap The gap to leave between bars in separate categories
private Timeline	dataRemoveTimeline
private static PseudoClass	HORIZONTAL_PSEUDOCLASS_STATE Pseudoclass indicating this is a horizontal chart.
private static java.lang.String	NEGATIVE_STYLE
private Orientation	orientation
private ParallelTransition	pt
private java.util.Map<XYChart.Series<X,Y>,java.util.Map<java.lang.String,XYChart.Data<X,Y>>>	seriesCategoryMap
private ValueAxis	valueAxis
private static PseudoClass	VERTICAL_PSEUDOCLASS_STATE Pseudoclass indicating this is a vertical chart.
private java.util.Map<XYChart.Data<X,Y>,java.lang.Double>	XYValueMap

Fields inherited from class javafx.scene.chart.XYChart

DEFAULT_COLOR, seriesColorMap

Fields inherited from class javafx.scene.chart.Chart

useChartContentMirroring

Constructor Summary

Constructors

Constructor and Description
BarChart(Axis<X> xAxis, Axis<Y> yAxis) Construct a new BarChart with the given axis.
BarChart(Axis<X> xAxis, Axis<Y> yAxis, <any> data) Construct a new BarChart with the given axis and data.
BarChart(Axis<X> xAxis, Axis<Y> yAxis, <any> data, double categoryGap) Construct a new BarChart with the given axis and data.

Method Summary

Modifier and Type	Method and Description
private void	animateDataAdd(XYChart.Data<X,Y> item, Node bar)
DoubleProperty	barGapProperty() The gap to leave between bars in the same category
DoubleProperty	categoryGapProperty() The gap to leave between bars in separate categories
private Node	createBar(XYChart.Series<X,Y> series, int seriesIndex, XYChart.Data<X,Y> item, int itemIndex)
private Timeline	createDataRemoveTimeline(XYChart.Data<X,Y> item, Node bar, XYChart.Series<X,Y> series)
(package private) LegendItem	createLegendItemForSeries(XYChart.Series<X,Y> series, int seriesIndex) Called by the updateLegend for each series in the chart in order to create new legend item
(package private) void	dataBeingRemovedIsAdded(XYChart.Data<X,Y> item, XYChart.Series<X,Y> series) This method is called when there is an attempt to add a Data item that was set to be removed, and the removal might not have completed.
protected void	dataItemAdded(XYChart.Series<X,Y> series, int itemIndex, XYChart.Data<X,Y> item) Called when a data item has been added to a series.
protected void	dataItemChanged(XYChart.Data<X,Y> item) Called when a data item has changed, ie its xValue, yValue or extraValue has changed.
protected void	dataItemRemoved(XYChart.Data<X,Y> item, XYChart.Series<X,Y> series) Called when a data item has been removed from data model but it is still visible on the chart.
double	getBarGap() Gets the value of the property barGap.
double	getCategoryGap() Gets the value of the property categoryGap.
static java.util.List<<any>>	getClassCssMetaData()
java.util.List<<any>>	getCssMetaData()
private XYChart.Data<X,Y>	getDataItem(XYChart.Series<X,Y> series, int seriesIndex, int itemIndex, java.lang.String category)
protected void	layoutPlotChildren() Called to update and layout the plot children.
private void	processDataRemove(XYChart.Series<X,Y> series, XYChart.Data<X,Y> item)
private void	restoreDataValues(XYChart.Data item)
protected void	seriesAdded(XYChart.Series<X,Y> series, int seriesIndex) A series has been added to the charts data model.
(package private) void	seriesBeingRemovedIsAdded(XYChart.Series<X,Y> series) This method is called when there is an attempt to add series that was set to be removed, and the removal might not have completed.
protected void	seriesChanged(<any> c) Called when each atomic change is made to the list of series for this chart
protected void	seriesRemoved(XYChart.Series<X,Y> series) A series has been removed from the data model but it is still visible on the chart.
void	setBarGap(double value) Sets the value of the property barGap.
void	setCategoryGap(double value) Sets the value of the property categoryGap.
private void	updateMap(XYChart.Series<X,Y> series, XYChart.Data<X,Y> item)

Methods inherited from class javafx.scene.chart.XYChart

alternativeColumnFillVisibleProperty, alternativeRowFillVisibleProperty, createSeriesRemoveTimeLine, currentDisplayedExtraValueProperty, currentDisplayedXValueProperty, currentDisplayedYValueProperty, dataProperty, getCurrentDisplayedExtraValue, getCurrentDisplayedXValue, getCurrentDisplayedYValue, getData, getDataSize, getDisplayedDataIterator, getDisplayedSeriesIterator, getPlotChildren, getSeriesIndex, getSeriesSize, getVerticalGridLinesVisible, getXAxis, getYAxis, horizontalGridLinesVisibleProperty, horizontalZeroLineVisibleProperty, isAlternativeColumnFillVisible, isAlternativeRowFillVisible, isHorizontalGridLinesVisible, isHorizontalZeroLineVisible, isVerticalZeroLineVisible, layoutChartChildren, removeDataItemFromDisplay, removeSeriesFromDisplay, setAlternativeColumnFillVisible, setAlternativeRowFillVisible, setCurrentDisplayedExtraValue, setCurrentDisplayedXValue, setCurrentDisplayedYValue, setData, setHorizontalGridLinesVisible, setHorizontalZeroLineVisible, setVerticalGridLinesVisible, setVerticalZeroLineVisible, updateAxisRange, updateLegend, verticalGridLinesVisibleProperty, verticalZeroLineVisibleProperty

Methods inherited from class javafx.scene.chart.Chart

animate, animate, animatedProperty, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, getAnimated, getChartChildren, getLegend, getLegendSide, getTitle, getTitleSide, isLegendVisible, layoutChildren, legendProperty, legendSideProperty, legendVisibleProperty, requestChartLayout, setAnimated, setLegend, setLegendSide, setLegendVisible, setTitle, setTitleSide, shouldAnimate, titleProperty, titleSideProperty

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Property Detail

barGap

public final DoubleProperty barGapProperty

The gap to leave between bars in the same category

See Also:

getBarGap(), setBarGap(double)

categoryGap

public final DoubleProperty categoryGapProperty

The gap to leave between bars in separate categories

See Also:

getCategoryGap(), setCategoryGap(double)

Field Detail

seriesCategoryMap

private java.util.Map<XYChart.Series<X,Y>,java.util.Map<java.lang.String,XYChart.Data<X,Y>>> seriesCategoryMap

orientation

private final Orientation orientation

categoryAxis

private CategoryAxis categoryAxis

valueAxis

private ValueAxis valueAxis

dataRemoveTimeline

private Timeline dataRemoveTimeline

bottomPos

private double bottomPos

NEGATIVE_STYLE

private static java.lang.String NEGATIVE_STYLE

pt

private ParallelTransition pt

XYValueMap

private java.util.Map<XYChart.Data<X,Y>,java.lang.Double> XYValueMap

barGap

private DoubleProperty barGap

The gap to leave between bars in the same category

categoryGap

private DoubleProperty categoryGap

The gap to leave between bars in separate categories

VERTICAL_PSEUDOCLASS_STATE

private static final PseudoClass VERTICAL_PSEUDOCLASS_STATE

Pseudoclass indicating this is a vertical chart.

HORIZONTAL_PSEUDOCLASS_STATE

private static final PseudoClass HORIZONTAL_PSEUDOCLASS_STATE

Pseudoclass indicating this is a horizontal chart.

Constructor Detail

BarChart

public BarChart(Axis<X> xAxis,
                Axis<Y> yAxis)

Construct a new BarChart with the given axis. The two axis should be a ValueAxis/NumberAxis and a CategoryAxis, they can be in either order depending on if you want a horizontal or vertical bar chart.

Parameters:

xAxis - The x axis to use

yAxis - The y axis to use

BarChart

public BarChart(Axis<X> xAxis,
                Axis<Y> yAxis,
                <any> data)

Construct a new BarChart with the given axis and data. The two axis should be a ValueAxis/NumberAxis and a CategoryAxis, they can be in either order depending on if you want a horizontal or vertical bar chart.

Parameters:

xAxis - The x axis to use

yAxis - The y axis to use

data - The data to use, this is the actual list used so any changes to it will be reflected in the chart

BarChart

public BarChart(Axis<X> xAxis,
                Axis<Y> yAxis,
                <any> data,
                double categoryGap)

Construct a new BarChart with the given axis and data. The two axis should be a ValueAxis/NumberAxis and a CategoryAxis, they can be in either order depending on if you want a horizontal or vertical bar chart.

Parameters:

xAxis - The x axis to use

yAxis - The y axis to use

data - The data to use, this is the actual list used so any changes to it will be reflected in the chart

categoryGap - The gap to leave between bars in separate categories

Method Detail

getBarGap

public final double getBarGap()

Gets the value of the property barGap.

setBarGap

public final void setBarGap(double value)

Sets the value of the property barGap.

barGapProperty

public final DoubleProperty barGapProperty()

The gap to leave between bars in the same category

See Also:

getBarGap(), setBarGap(double)

getCategoryGap

public final double getCategoryGap()

Gets the value of the property categoryGap.

setCategoryGap

public final void setCategoryGap(double value)

Sets the value of the property categoryGap.

categoryGapProperty

public final DoubleProperty categoryGapProperty()

The gap to leave between bars in separate categories

See Also:

getCategoryGap(), setCategoryGap(double)

dataItemAdded

protected void dataItemAdded(XYChart.Series<X,Y> series,
                             int itemIndex,
                             XYChart.Data<X,Y> item)

Description copied from class: XYChart

Called when a data item has been added to a series. This is where implementations of XYChart can create/add new nodes to getPlotChildren to represent this data item. They also may animate that data add with a fade in or similar if animated = true.

Specified by:

dataItemAdded in class XYChart<X,Y>

Parameters:

series - The series the data item was added to

itemIndex - The index of the new item within the series

item - The new data item that was added

dataItemRemoved

protected void dataItemRemoved(XYChart.Data<X,Y> item,
                               XYChart.Series<X,Y> series)

Description copied from class: XYChart

Called when a data item has been removed from data model but it is still visible on the chart. Its still visible so that you can handle animation for removing it in this method. After you are done animating the data item you must call removeDataItemFromDisplay() to remove the items node from being displayed on the chart.

Specified by:

dataItemRemoved in class XYChart<X,Y>

Parameters:

item - The item that has been removed from the series

series - The series the item was removed from

dataItemChanged

protected void dataItemChanged(XYChart.Data<X,Y> item)

Called when a data item has changed, ie its xValue, yValue or extraValue has changed.

Specified by:

dataItemChanged in class XYChart<X,Y>

Parameters:

item - The data item who was changed

seriesChanged

protected void seriesChanged(<any> c)

Description copied from class: XYChart

Called when each atomic change is made to the list of series for this chart

Overrides:

seriesChanged in class XYChart<X,Y>

Parameters:

c - a Change instance representing the changes to the series

seriesAdded

protected void seriesAdded(XYChart.Series<X,Y> series,
                           int seriesIndex)

Description copied from class: XYChart

A series has been added to the charts data model. This is where implementations of XYChart can create/add new nodes to getPlotChildren to represent this series. Also you have to handle adding any data items that are already in the series. You may simply call dataItemAdded() for each one or provide some different animation for a whole series being added.

Specified by:

seriesAdded in class XYChart<X,Y>

Parameters:

series - The series that has been added

seriesIndex - The index of the new series

seriesRemoved

protected void seriesRemoved(XYChart.Series<X,Y> series)

Description copied from class: XYChart

A series has been removed from the data model but it is still visible on the chart. Its still visible so that you can handle animation for removing it in this method. After you are done animating the data item you must call removeSeriesFromDisplay() to remove the series from the display list.

Specified by:

seriesRemoved in class XYChart<X,Y>

Parameters:

series - The series that has been removed

layoutPlotChildren

protected void layoutPlotChildren()

Called to update and layout the plot children. This should include all work to updates nodes representing the plot on top of the axis and grid lines etc. The origin is the top left of the plot area, the plot area with can be got by getting the width of the x axis and its height from the height of the y axis.

Specified by:

layoutPlotChildren in class XYChart<X,Y>

createLegendItemForSeries

LegendItem createLegendItemForSeries(XYChart.Series<X,Y> series,
                                     int seriesIndex)

Description copied from class: XYChart

Called by the updateLegend for each series in the chart in order to create new legend item

Overrides:

createLegendItemForSeries in class XYChart<X,Y>

Parameters:

series - the series for this legend item

seriesIndex - the index of the series

Returns:

new legend item for this series

updateMap

private void updateMap(XYChart.Series<X,Y> series,
                       XYChart.Data<X,Y> item)

processDataRemove

private void processDataRemove(XYChart.Series<X,Y> series,
                               XYChart.Data<X,Y> item)

animateDataAdd

private void animateDataAdd(XYChart.Data<X,Y> item,
                            Node bar)

createDataRemoveTimeline

private Timeline createDataRemoveTimeline(XYChart.Data<X,Y> item,
                                          Node bar,
                                          XYChart.Series<X,Y> series)

dataBeingRemovedIsAdded

void dataBeingRemovedIsAdded(XYChart.Data<X,Y> item,
                             XYChart.Series<X,Y> series)

Description copied from class: XYChart

This method is called when there is an attempt to add a Data item that was set to be removed, and the removal might not have completed.

Overrides:

dataBeingRemovedIsAdded in class XYChart<X,Y>

restoreDataValues

private void restoreDataValues(XYChart.Data item)

seriesBeingRemovedIsAdded

void seriesBeingRemovedIsAdded(XYChart.Series<X,Y> series)

Description copied from class: XYChart

This method is called when there is an attempt to add series that was set to be removed, and the removal might not have completed.

Overrides:

seriesBeingRemovedIsAdded in class XYChart<X,Y>

createBar

private Node createBar(XYChart.Series<X,Y> series,
                       int seriesIndex,
                       XYChart.Data<X,Y> item,
                       int itemIndex)

getDataItem

private XYChart.Data<X,Y> getDataItem(XYChart.Series<X,Y> series,
                                      int seriesIndex,
                                      int itemIndex,
                                      java.lang.String category)

getClassCssMetaData

public static java.util.List<<any>> getClassCssMetaData()

Returns:

The CssMetaData associated with this class, which may include the CssMetaData of its superclasses.

Since:

JavaFX 8.0

getCssMetaData

public java.util.List<<any>> getCssMetaData()

Overrides:

getCssMetaData in class XYChart<X,Y>

Since:

JavaFX 8.0