Qt Documentation

Contents

AreaSeries QML Type

Presents data in area charts. More...

Import Statement: import QtCharts 2.2
Instantiates: QAreaSeries
Inherits:

AbstractSeries

Properties

Signals

Detailed Description

The following QML shows how to create a simple area chart:

ChartView {
    title: "NHL All-Star Team Players"
    anchors.fill: parent
    antialiasing: true

    ValueAxis {
        id: valueAxis
        min: 2000
        max: 2011
        tickCount: 12
        labelFormat: "%.0f"
    }

    AreaSeries {
        name: "Russian"
        color: "#FFD52B1E"
        borderColor: "#FF0039A5"
        borderWidth: 3
        axisX: valueAxis
        upperSeries: LineSeries {
            XYPoint { x: 2000; y: 1 }
            XYPoint { x: 2001; y: 1 }
            XYPoint { x: 2002; y: 1 }
            XYPoint { x: 2003; y: 1 }
            XYPoint { x: 2004; y: 1 }
            XYPoint { x: 2005; y: 0 }
            XYPoint { x: 2006; y: 1 }
            XYPoint { x: 2007; y: 1 }
            XYPoint { x: 2008; y: 4 }
            XYPoint { x: 2009; y: 3 }
            XYPoint { x: 2010; y: 2 }
            XYPoint { x: 2011; y: 1 }
        }
    }


Note: Adding the same line series to a chart and area series is not supported. The series used as boundary lines should be defined only for the area series.

Property Documentation

borderColor : color

Line (pen) color of the series.


borderWidth : real

The width of the border line. By default, the width is 2.0.


brushFilename : QString

The name of the file used as a brush image for the series.


color : color

Fill (brush) color of the series.


lowerSeries : LineSeries

The lower one of the two line series used to define area series boundaries.

Note: If AreaSeries was constructed without a lowerSeries, this is null.


pointLabelsClipping : bool

Defines the clipping for data point labels. True by default. The labels on the edge of the plot area are cut when clipping is enabled.

See also pointLabelsVisible.


pointLabelsColor : font

Defines the color used for data point labels. By default, the color is the color of the brush defined for labels in the theme.

See also pointLabelsFormat.


pointLabelsFont : font

Defines the font used for data point labels.

See also pointLabelsFormat.


pointLabelsFormat : string

The format used for showing labels with series points.

See also QAreaSeries::pointLabelsFormat, pointLabelsVisible, pointLabelsFont, and pointLabelsColor.


pointLabelsVisible : bool

Defines the visibility of data point labels.

See also pointLabelsFormat and pointLabelsClipping.


upperSeries : LineSeries

The upper one of the two line series used to define area series boundaries.


Signal Documentation

clicked(point point)

This signal is emitted when the user triggers a press on point by clicking it in an area chart.

The corresponding signal handler is onClicked.

See also pressed, released, and doubleClicked.


doubleClicked(point point)

This signal is emitted when the user triggers the first press in an area chart by doubleclicking point.

The corresponding signal handler is onDoubleClicked.

See also pressed, released, and clicked.


hovered(point point, bool state)

This signal is emitted when the user hovers the mouse cursor over a series or moves it away from the series. point shows the origin (coordinate) of the hover event. state is true when the cursor hovers over the series and turns false when it moves away from the series.

The corresponding signal handler is onHovered.


pressed(point point)

This signal is emitted when the user presses the point specified by point in an area chart.

The corresponding signal handler is onPressed.

See also clicked, released, and doubleClicked.


released(point point)

This signal is emitted when the user releases a press that was triggered on point in an area chart.

The corresponding signal handler is onReleased.

See also pressed, clicked, and doubleClicked.


© 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.