Module javafx.controls
Package javafx.scene.chart

Class BarChart<X,Y>

  • All Implemented Interfaces:
    Styleable, EventTarget

    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

    • 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,
                ObservableList<XYChart.Series<X,Y>> 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,
                ObservableList<XYChart.Series<X,Y>> 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.
        Property description:
        The gap to leave between bars in the same category

      • setBarGap

        public final void setBarGap​(double value)
        Sets the value of the property barGap.
        Property description:
        The gap to leave between bars in the same category

      • getCategoryGap

        public final double getCategoryGap​()
        Gets the value of the property categoryGap.
        Property description:
        The gap to leave between bars in separate categories

      • setCategoryGap

        public final void setCategoryGap​(double value)
        Sets the value of the property categoryGap.
        Property description:
        The gap to leave between bars in separate categories

      • 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​(ListChangeListener.Change<? extends XYChart.Series> 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>

      • getClassCssMetaData

        public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData​()
        Returns:
        The CssMetaData associated with this class, which may include the CssMetaData of its superclasses.
        Since:
        JavaFX 8.0