- Qt 6.8
- Qt Charts
- Qt Charts C++ Classes
- Qt Charts | Commercial or GPLv3

# Qt Charts C++ Classes

C++ classes for the Qt Charts API. More...

## Classes

QAbstractAxis | Base class used for specialized axis classes
QAbstractBarSeries | Abstract parent class for all bar series classes
QAbstractSeries | Base class for all Qt Chart series
QAreaLegendMarker | Legend marker for an area series
QAreaSeries | Presents data in area charts
QBarCategoryAxis | Adds categories to a chart's axes
QBarLegendMarker | Legend marker for a bar series
QBarSeries | Presents a series of data as vertical bars grouped by category
QBarSet | Represents one set of bars in a bar chart
QBoxPlotLegendMarker | Legend marker for a box plot series
QBoxPlotSeries | Presents data in box-and-whiskers charts
QBoxSet | Represents one item in a box-and-whiskers chart
QCandlestickLegendMarker | Legend marker for a candlestick series
QCandlestickModelMapper | Abstract model mapper class for candlestick series
QCandlestickSeries | Presents data as candlesticks
QCandlestickSet | Represents a single candlestick item in a candlestick chart
QCategoryAxis | Places named ranges on the axis
QChart | Manages the graphical representation of the chart's series, legends, and axes
QChartView | Standalone widget that can display charts
QColorAxis | Displays a color scale as one of the chart's axes
QDateTimeAxis | Adds dates and times to a chart's axis
QHBarModelMapper | Horizontal model mapper for bar series
QHBoxPlotModelMapper | Horizontal model mapper for box plot series
QHCandlestickModelMapper | Horizontal model mapper for a candlestick series
QHPieModelMapper | Horizontal model mapper for pie series
QHXYModelMapper | Horizontal model mapper for line, spline, and scatter series
QHorizontalBarSeries | Presents a series of data as horizontal bars grouped by category
QHorizontalPercentBarSeries | Presents a series of categorized data as a percentage of each category
QHorizontalStackedBarSeries | Presents a series of data as horizontally stacked bars, with one bar per category
QLegend | Displays the legend of a chart
QLegendMarker | Abstract object that can be used to access markers within a legend
QLineSeries | Presents data in line charts
QLogValueAxis | Adds a logarithmic scale to a chart's axis
QPercentBarSeries | Presents a series of categorized data as a percentage of each category
QPieLegendMarker | Legend marker for a pie series
QPieSeries | Presents data in pie charts
QPieSlice | Represents a single slice in a pie series
QPolarChart | Presents data in polar charts
QScatterSeries | Presents data in scatter charts
QSplineSeries | Presents data as spline charts
QStackedBarSeries | Presents a series of data as vertically stacked bars, with one bar per category
QVBarModelMapper | Vertical model mapper for bar series
QVBoxPlotModelMapper | Vertical model mapper for box plot series
QVCandlestickModelMapper | Vertical model mapper for a candlestick series
QVPieModelMapper | Vertical model mapper for pie series
QVXYModelMapper | Vertical model mapper for line, spline, and scatter series
QValueAxis | Adds values to a chart's axes
QXYLegendMarker | Legend marker for a line, spline, or scatter series
QXYSeries | Base class for line, spline, and scatter series

## Detailed Description

Charts API is built on top of Qt Graphics View Framework. Charts can be displayed as QGraphicsWidget using the QChart class. However there is also the convenience class QChartView, which is QWidget based. These enable us to quickly use Qt Charts as a normal Qt widget.

Note: The Qt Charts module is in the maintenance phase. For new projects, consider using the Qt Graphs module. To render 2D charts, QtGraphs uses Qt Quick Shapes, which is a more modern GUI technology compared to the outdated Qt Graphics View Framework used by the Qt Charts module.

If you intend to use Qt Charts C++ classes in your application, use the following include and using directives:

     #include <QtCharts>

     using namespace QtCharts;

Note: Projects created with Qt Creator's Qt Quick Application wizard are based on the Qt Quick 2 template that uses QGuiApplication by default. All such QGuiApplication instances in the project must be replaced with QApplication as the module depends on Qt's Graphics View Framework for rendering.

To link against the Qt Charts module, add this line to your `qmake` project file:

     QT += charts

Each chart type is represented by the QAbstractSeries derived class. To create charts, the users have to use an instance of the related series class and add it to a QChart instance.

     QLineSeries* series = new QLineSeries();
     series->append(0, 6);
     series->append(2, 4);
     ...
     chartView->chart()->addSeries(series);
     chartView->chart()->createDefaultAxes();