Qt 5.13 | Qt Charts | QML Types | BoxPlotSeries QML Type

Qt Charts | Commercial or GPLv3

# BoxPlotSeries QML Type

Presents data in box-and-whiskers charts. More...

Import Statement: | import QtCharts 2.13
Inherits: | AbstractSeries

- List of all members, including inherited members

## Properties

- axisX : AbstractAxis
- axisXTop : AbstractAxis
- axisY : AbstractAxis
- axisYRight : AbstractAxis
- boxOutlineVisible : bool
- boxWidth : real
- brushFilename : string
- count : int

## Signals

- boxsetsAdded(sets)
- boxsetsRemoved(sets)
- clicked(boxset)
- doubleClicked(boxset)
- hovered(status, BoxSet boxset)
- pressed(boxset)
- released(boxset)

## Methods

- append(box)
- append(label, VariantList values)
- at(index)
- clear()
- insert(index, string label, VariantList values)
- remove(boxset)

## Detailed Description

A box plot series acts as a container for box-and-whiskers items. Items from multiple series are grouped into categories according to their index value.

The BarCategoryAxis class is used to add the categories to the chart's axis. Category labels have to be unique. If the same category label is defined for several box-and-whiskers items, only the first one is drawn.

The following QML code snippet shows how to create a simple box-and-whiskers chart:

      import QtQuick 2.0
      import QtCharts 2.0

      ChartView {
          title: "Box Plot series"
          width: 400
          height: 300
          theme: ChartView.ChartThemeBrownSand
          legend.alignment: Qt.AlignBottom

          BoxPlotSeries {
              id: plotSeries
              name: "Income"
              BoxSet { label: "Jan"; values: [3, 4, 5.1, 6.2, 8.5] }
              BoxSet { label: "Feb"; values: [5, 6, 7.5, 8.6, 11.8] }
              BoxSet { label: "Mar"; values: [3.2, 5, 5.7, 8, 9.2] }
              BoxSet { label: "Apr"; values: [3.8, 5, 6.4, 7, 8] }
              BoxSet { label: "May"; values: [4, 5, 5.2, 6, 7] }
          }
      }

See also BoxSet and BarCategoryAxis.

## Property Documentation

axisX : AbstractAxis

The x-axis used for the series. If you leave both axisX and axisXTop undefined, a BarCategoryAxis is created for the series.

See also axisXTop.

axisXTop : AbstractAxis

The x-axis used for the series, drawn on top of the chart view.

Note: You can only provide either axisX or axisXTop, but not both.

See also axisX and axisX.

axisY : AbstractAxis

The y-axis used for the series. If you leave both axisY and axisYRight undefined, a ValueAxis is created for the series.

See also axisYRight.

axisYRight : AbstractAxis

The y-axis used for the series, drawn to the right on the chart view.

Note: You can only provide either axisY or axisYRight, but not both.

See also axisY.

boxOutlineVisible : bool

The visibility of the box outline.

boxWidth : real

The width of the box-and-whiskers item. The value indicates the relative width of the item within its category. The value can be between 0.0 and 1.0. Negative values are replaced with 0.0 and values greater than 1.0 are replaced with 1.0.

brushFilename : string

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

count : int

The number of box-and-whiskers items in a box plot series.

## Signal Documentation

boxsetsAdded(sets)

This signal is emitted when the box-and-whiskers items specified by sets are added to the series.

The corresponding signal handler is `onBoxsetsAdded()`.

boxsetsRemoved(sets)

This signal is emitted when the box-and-whiskers items specified by sets are removed from the series.

The corresponding signal handler is `onBoxsetsRemoved()`.

clicked(boxset)

This signal is emitted when the user clicks the box-and-whiskers item specified by boxset in the chart.

The corresponding signal handler is `onClicked()`.

doubleClicked(boxset)

This signal is emitted when the user double-clicks the box-and-whiskers item specified by boxset in the chart.

The corresponding signal handler is `onDoubleClicked()`.

hovered(status, BoxSet boxset)

This signal is emitted when a mouse is hovered over the box-and-whiskers item specified by boxset in the chart. When the mouse moves over the item, status turns `true`, and when the mouse moves away again, it turns `false`.

The corresponding signal handler is `onHovered()`.

pressed(boxset)

This signal is emitted when the user presses the boxset on the chart.

The corresponding signal handler is `onPressed`.

released(boxset)

This signal is emitted when the user releases the mouse press on the box-and-whiskers item specified by boxset in the chart.

The corresponding signal handler is `onReleased()`.

## Method Documentation

append(box)

Appends the box-and-whiskers item specified by box to the series.

append(label, VariantList values)

Appends a new box-and-whiskers item with the label specified by label and the values specified by values to the series.

at(index)

Returns the box-and-whiskers item in the position specified by index.

clear()

Removes all box-and-whiskers items from the series and permanently deletes them.

insert(index, string label, VariantList values)

Inserts a new box-and-whiskers item with the label specified by label and the values specified by values to the series at the position specified by index.

remove(boxset)

Removes the box-and-whiskers item specified by boxset from the series.