Qt Charts QML Types

The Qt Charts QML API is an intuitive and simple way to show charts in your QML applications.

Use the following QML to create a simple pie chart:

import QtQuick 2.0
import QtCharts 2.0

ChartView {
    width: 400
    height: 300
    theme: ChartView.ChartThemeBrownSand
    antialiasing: true

    PieSeries {
        id: pieSeries
        PieSlice { label: "eaten"; value: 94.9 }
        PieSlice { label: "not yet eaten"; value: 5.1 }
    }
}

Note: Since Qt Creator 3.0 the project created with Qt Quick Application wizard based on Qt Quick 2 template uses QGuiApplication by default. As Qt Charts utilizes Qt Graphics View Framework for drawing, QApplication must be used. The project created with the wizard is usable with Qt Charts after the QGuiApplication is replaced with QApplication.

QML Types

AreaSeries

Presents data in area charts

BarCategoryAxis

Adds categories to a chart's axes

CategoryAxis

Places named ranges on the axis

DateTimeAxis

Adds dates and times to a chart's axis

LogValueAxis

Adds a logarithmic scale to a chart's axis

AbstractAxis

A base type used for specialized axis types

ValueAxis

Adds values to a chart's axes

HorizontalBarSeries

Presents a series of data as horizontal bars grouped by category

HorizontalPercentBarSeries

Presents a series of categorized data as a percentage of each category

HorizontalStackedBarSeries

Presents a series of data as stacked horizontal bars, with one bar per category

AbstractBarSeries

An abstract parent type for all bar series types

BarSet

Represents one set of bars in a bar chart

HBarModelMapper

Horizontal model mapper for bar series

VBarModelMapper

Vertical model mapper for bar series

BarSeries

Presents a series of data as vertical bars grouped by category

PercentBarSeries

Presents a series of categorized data as a percentage of each category

StackedBarSeries

Presents a series of data as vertically stacked bars, with one bar per category

HBoxPlotModelMapper

Horizontal model mapper for box plot series

VBoxPlotModelMapper

Vertical model mapper for box plot series

CandlestickSeries

Represents a series of data as candlesticks

CandlestickSet

Represents a single candlestick item in a candlestick chart

HCandlestickModelMapper

Horizontal model mapper for a candlestick series

VCandlestickModelMapper

Vertical model mapper for a candlestick series

Legend

Displays the legend of a chart

LineSeries

Presents data in line charts

HPieModelMapper

Horizontal model mapper for pie series

PieSeries

Type is used for making pie charts

PieSlice

Defines a slice in pie series

VPieModelMapper

Vertical model mapper for pie series

AbstractSeries

Base type for all Qt Chart series types

ScatterSeries

Type is used for making scatter charts

SplineSeries

Type is used for making spline charts

HXYModelMapper

Horizontal model mapper for QXYSeries

VXYModelMapper

Vertical model mapper for QXYSeries

XYSeries

Type is a base type for line, spline and scatter series

BoxPlotSeries

Presents data in box-and-whiskers charts

BoxSet

Represents one item in a box-and-whiskers chart

CategoryRange

With CategoryRange you can define a range used by a CategoryAxis

ChartView

Chart element

Margins

Type is used to define margins

PolarChartView

Polar chart element

XYPoint

Type is used to initialize XY-series coordinate data

© 2017 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.