Revision control
++ // Copyright (C) 2016 The Qt Company Ltd.
++ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
++
++ #undef QT_NO_FOREACH // this file contains unported legacy Q_FOREACH uses
++
++ #include "declarativebarseries_p.h"
++ #include "declarativeboxplotseries_p.h"
++ #include <QtCharts/QBoxSet>
++ #include <QtCharts/QHBoxPlotModelMapper>
++ #include <QtCharts/QVBoxPlotModelMapper>
++
++ QT_BEGIN_NAMESPACE
++
++ /*!
++ \qmltype BoxSet
++ \nativetype QBoxSet
++ \inqmlmodule QtCharts
++
++ \brief Represents one item in a box-and-whiskers chart.
++
++ A box-and-whiskers item is a graphical representation of a range and three median values
++ that is constructed from five different values. There are two ways to specify the values.
++ The first one is by using a constructor or the append() method. The values have to be
++ specified in the following order: lower extreme, lower quartile, median, upper quartile,
++ and upper extreme.
++
++ The second way is to create an empty BoxSet instance and specify the values using the
++ setValue() method.
++
++ \sa BoxPlotSeries
++ */
++
++ /*!
++ \qmlproperty list BoxSet::values
++ The values of the box-and-whiskers item. The following enumerations can be
++ used as indexes when accessing the list of values:
++
++ \value BoxSet.LowerExtreme The smallest value of the box-and-whiskers item.
++ \value BoxSet.LowerQuartile The median value of the lower half of the box-and-whiskers item.
++ \value BoxSet.Median The median value of the box-and-whiskers item.
++ \value BoxSet.UpperQuartile The median value of the upper half of the box-and-whiskers item.
++ \value BoxSet.UpperExtreme The largest value of the box-and-whiskers item.
++
++ \sa at(), setValue()
++ */
++ /*!
++ \qmlproperty string BoxSet::label
++ The label of the category of the box-and-whiskers item.
++ */
++ /*!
++ \qmlproperty int BoxSet::count
++ The number of values of the box-and-whiskers item.
++ */
++
++ /*!
++ \qmlproperty string BoxSet::brushFilename
++ The name of the file used as a brush for the box-and-whiskers item.
++ */
++
++ /*!
++ \qmlmethod real BoxSet::at(int index)
++ Returns the value in the position specified by \a index.
++ */
++ /*!
++ \qmlmethod void BoxSet::append(real value)
++ Appends the new value specified by \a value to the end of the box-and-whiskers item.
++ */
++ /*!
++ \qmlmethod void BoxSet::clear()
++ Sets all the values of the box-and-whiskers item to 0.
++ */
++ /*!
++ \qmlmethod void BoxSet::setValue(int index, qreal value)
++ Sets the value specified by \a value in the position specified by \a index.
++ */
++ /*!
++ \qmlsignal BoxSet::clicked()
++ This signal is emitted when the user clicks a box-and-whiskers item in the chart.
++
++ The corresponding signal handler is \c onClicked().
++ */
++ /*!
++ \qmlsignal BoxSet::pressed()
++ This signal is emitted when the user clicks a box-and-whiskers item in the chart
++ and holds down the mouse button.
++
++ The corresponding signal handler is \c onPressed.
++ */
++ /*!
++ \qmlsignal BoxSet::released()
++ This signal is emitted when the user releases the mouse press on a box-and-whiskers item.
++
++ The corresponding signal handler is \c onReleased().
++ */
++ /*!
++ \qmlsignal BoxSet::doubleClicked()
++ This signal is emitted when the user double-clicks a box-and-whiskers item.
++
++ The corresponding signal handler is \c onDoubleClicked().
++ */
++ /*!
++ \qmlsignal BoxSet::hovered(bool status)
++ This signal is emitted when a mouse is hovered over a box-and-whiskers item in a chart.
++ When the mouse moves over the item, \a status turns \c true, and when the mouse moves
++ away again, it turns \c false.
++
++ The corresponding signal handler is \c onHovered().
++ */
++ /*!
++ \qmlsignal BoxSet::valuesChanged()
++ This signal is emitted when multiple values of the box-and-whiskers item change.
++
++ The corresponding signal handler is \c onValuesChanged().
++ */
++ /*!
++ \qmlsignal BoxSet::valueChanged(int index)
++ This signal is emitted when the value of the box-and-whiskers item specified by \a index
++ changes.
++
++ The corresponding signal handler is \c onValueChanged().
++ */
++ /*!
++ \qmlsignal BoxSet::cleared()
++ This signal is emitted when all the values of the box-and-whiskers item are set to 0.
++
++ The corresponding signal handler is \c onCleared().
++ */
++
++ /*!
++ \qmltype BoxPlotSeries
++ \nativetype QBoxPlotSeries
++ \inqmlmodule QtCharts
++
++ \inherits AbstractSeries
++
++ \brief Presents data in box-and-whiskers charts.
++
++ 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:
++ \code
++ 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] }
++ }
++ }
++ \endcode
++
++ \beginfloatleft
++ \image examples_qmlboxplot.png {Screenshot showing a box plot chart displaying an income
++ across five months from January to May}
++ \endfloat
++ \clearfloat
++
++ \sa BoxSet, BarCategoryAxis
++ */
++
++ /*!
++ \qmlmethod BoxSet BoxPlotSeries::at(int index)
++ Returns the box-and-whiskers item in the position specified by \a index.
++ */
++
++ /*!
++ \qmlmethod void BoxPlotSeries::append(string label, VariantList values)
++ Appends a new box-and-whiskers item with the label specified by \a label and the values
++ specified by \a values to the series.
++ */
++ /*!
++ \qmlmethod void BoxPlotSeries::append(BoxSet box)
++ Appends the box-and-whiskers item specified by \a box to the series.
++ */
++ /*!
++ \qmlmethod void BoxPlotSeries::insert(int index, string label, VariantList values)
++ Inserts a new box-and-whiskers item with the label specified by \a label and the values
++ specified by \a values to the series at the position specified by \a index.
++ */
++ /*!
++ \qmlmethod void BoxPlotSeries::remove(QBoxSet boxset)
++ Removes the box-and-whiskers item specified by \a boxset from the series.
++ */
++ /*!
++ \qmlmethod void BoxPlotSeries::clear()
++ Removes all box-and-whiskers items from the series and permanently deletes them.
++ */
++ /*!
++ \qmlsignal BoxPlotSeries::clicked(BoxSet boxset);
++ This signal is emitted when the user clicks the box-and-whiskers item specified by
++ \a boxset in the chart.
++
++ The corresponding signal handler is \c onClicked().
++ */
++ /*!
++ \qmlsignal BoxPlotSeries::hovered(bool status, BoxSet boxset);
++ This signal is emitted when a mouse is hovered over the box-and-whiskers item specified by
++ \a boxset in the chart. When the mouse moves over the item, \a status turns \c true, and
++ when the mouse moves away again, it turns \c false.
++
++ The corresponding signal handler is \c onHovered().
++ */
++ /*!
++ \qmlsignal BoxPlotSeries::pressed(BoxSet boxset)
++ This signal is emitted when the user presses the \a boxset on the chart.
++
++ The corresponding signal handler is \c onPressed.
++ */
++ /*!
++ \qmlsignal BoxPlotSeries::released(BoxSet boxset)
++ This signal is emitted when the user releases the mouse press on the box-and-whiskers
++ item specified by \a boxset in the chart.
++
++ The corresponding signal handler is \c onReleased().
++ */
++ /*!
++ \qmlsignal BoxPlotSeries::doubleClicked(BoxSet boxset)
++ This signal is emitted when the user double-clicks the box-and-whiskers item specified by
++ \a boxset in the chart.
++
++ The corresponding signal handler is \c onDoubleClicked().
++ */
++ /*!
++ \qmlsignal BoxPlotSeries::boxsetsAdded(list sets)
++ This signal is emitted when the box-and-whiskers items specified by \a sets
++ are added to the series.
++
++ The corresponding signal handler is \c onBoxsetsAdded().
++ */
++ /*!
++ \qmlsignal BoxPlotSeries::boxsetsRemoved(list sets)
++ This signal is emitted when the box-and-whiskers items specified by \a sets
++ are removed from the series.
++
++ The corresponding signal handler is \c onBoxsetsRemoved().
++ */
++ /*!
++ \qmlproperty AbstractAxis BoxPlotSeries::axisX
++ The x-axis used for the series. If you leave both axisX and axisXTop undefined, a
++ BarCategoryAxis is created for the series.
++ \sa axisXTop
++ */
++ /*!
++ \qmlproperty AbstractAxis BoxPlotSeries::axisY
++ The y-axis used for the series. If you leave both axisY and axisYRight undefined, a
++ ValueAxis is created for the series.
++ \sa axisYRight
++ */
++ /*!
++ \qmlproperty AbstractAxis BoxPlotSeries::axisXTop
++ 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.
++ \sa axisX
++
++ \sa axisX
++ */
++ /*!
++ \qmlproperty AbstractAxis BoxPlotSeries::axisYRight
++ 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.
++ \sa axisY
++ */
++ /*!
++ \qmlproperty bool BoxPlotSeries::boxOutlineVisible
++ The visibility of the box outline.
++ */
++ /*!
++ \qmlproperty real BoxPlotSeries::boxWidth
++ \brief 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.
++ */
++
++ /*!
++ \qmlproperty string BoxPlotSeries::brushFilename
++ The name of the file used as a brush for the series.
++ */
++
++ /*!
++ \qmlproperty int BoxPlotSeries::count
++ The number of box-and-whiskers items in a box plot series.
++ */
++
++
++ DeclarativeBoxSet::DeclarativeBoxSet(const QString label, QObject *parent)
++ : QBoxSet(label, parent)
++ {
++ connect(this, SIGNAL(valuesChanged()), this, SIGNAL(changedValues()));
++ connect(this, SIGNAL(valueChanged(int)), this, SIGNAL(changedValue(int)));
++ connect(this, SIGNAL(brushChanged()), this, SLOT(handleBrushChanged()));
++ }
++
++ QVariantList DeclarativeBoxSet::values()
++ {
++ QVariantList values;
++ for (int i(0); i < 5; i++)
++ values.append(QVariant(QBoxSet::at(i)));
++ return values;
++ }
++
++ void DeclarativeBoxSet::setValues(QVariantList values)
++ {
++ for (int i(0); i < values.size(); i++) {
++ if (values.at(i).canConvert<double>())
++ QBoxSet::append(values[i].toDouble());
++ }
++ }
++
++ QString DeclarativeBoxSet::brushFilename() const
++ {
++ return m_brushFilename;
++ }
++
++ void DeclarativeBoxSet::setBrushFilename(const QString &brushFilename)
++ {
++ QImage brushImage(brushFilename);
++ if (QBoxSet::brush().textureImage() != brushImage) {
++ QBrush brush = QBoxSet::brush();
++ brush.setTextureImage(brushImage);
++ QBoxSet::setBrush(brush);
++ m_brushFilename = brushFilename;
++ m_brushImage = brushImage;
++ emit brushFilenameChanged(brushFilename);
++ }
++ }
++
++ void DeclarativeBoxSet::handleBrushChanged()
++ {
++ // If the texture image of the brush has changed along the brush
++ // the brush file name needs to be cleared.
++ if (!m_brushFilename.isEmpty() && QBoxSet::brush().textureImage() != m_brushImage) {
++ m_brushFilename.clear();
++ emit brushFilenameChanged(QString());
++ }
++ }
++
++ // =====================================================
++
++ DeclarativeBoxPlotSeries::DeclarativeBoxPlotSeries(QQuickItem *parent) :
++ QBoxPlotSeries(parent),
++ m_axes(new DeclarativeAxes(this))
++ {
++ connect(m_axes, SIGNAL(axisXChanged(QAbstractAxis*)), this, SIGNAL(axisXChanged(QAbstractAxis*)));
++ connect(m_axes, SIGNAL(axisYChanged(QAbstractAxis*)), this, SIGNAL(axisYChanged(QAbstractAxis*)));
++ connect(m_axes, SIGNAL(axisXTopChanged(QAbstractAxis*)), this, SIGNAL(axisXTopChanged(QAbstractAxis*)));
++ connect(m_axes, SIGNAL(axisYRightChanged(QAbstractAxis*)), this, SIGNAL(axisYRightChanged(QAbstractAxis*)));
++ connect(this, SIGNAL(hovered(bool,QBoxSet*)), this, SLOT(onHovered(bool,QBoxSet*)));
++ connect(this, SIGNAL(clicked(QBoxSet*)), this, SLOT(onClicked(QBoxSet*)));
++ connect(this, SIGNAL(brushChanged()), this, SLOT(handleBrushChanged()));
++ connect(this, SIGNAL(pressed(QBoxSet*)), this, SLOT(onPressed(QBoxSet*)));
++ connect(this, SIGNAL(released(QBoxSet*)), this, SLOT(onReleased(QBoxSet*)));
++ connect(this, SIGNAL(doubleClicked(QBoxSet*)), this, SLOT(onDoubleClicked(QBoxSet*)));
++ }
++
++ void DeclarativeBoxPlotSeries::classBegin()
++ {
++ }
++
++ void DeclarativeBoxPlotSeries::componentComplete()
++ {
++ const auto childlist = children();
++ for (QObject *child : childlist) {
++ if (qobject_cast<DeclarativeBoxSet *>(child)) {
++ QBoxPlotSeries::append(qobject_cast<DeclarativeBoxSet *>(child));
++ } else if (qobject_cast<QVBoxPlotModelMapper *>(child)) {
++ QVBoxPlotModelMapper *mapper = qobject_cast<QVBoxPlotModelMapper *>(child);
++ mapper->setSeries(this);
++ } else if (QHBoxPlotModelMapper *mapper = qobject_cast<QHBoxPlotModelMapper *>(child)) {
++ mapper->setSeries(this);
++ }
++ }
++ }
++
++ QQmlListProperty<QObject> DeclarativeBoxPlotSeries::seriesChildren()
++ {
++ return QQmlListProperty<QObject>(this, 0, &DeclarativeBoxPlotSeries::appendSeriesChildren ,0,0,0);
++ }
++
++ void DeclarativeBoxPlotSeries::appendSeriesChildren(QQmlListProperty<QObject> *list, QObject *element)
++ {
++ // Empty implementation; the children are parsed in componentComplete instead
++ Q_UNUSED(list);
++ Q_UNUSED(element);
++ }
++
++ DeclarativeBoxSet *DeclarativeBoxPlotSeries::at(int index)
++ {
++ QList<QBoxSet *> setList = boxSets();
++ if (index >= 0 && index < setList.size())
++ return qobject_cast<DeclarativeBoxSet *>(setList[index]);
++
++ return 0;
++ }
++
++ DeclarativeBoxSet *DeclarativeBoxPlotSeries::insert(int index, const QString label, QVariantList values)
++ {
++ DeclarativeBoxSet *barset = new DeclarativeBoxSet(label, this);
++ barset->setValues(values);
++ if (QBoxPlotSeries::insert(index, barset))
++ return barset;
++ delete barset;
++ return 0;
++ }
++
++ void DeclarativeBoxPlotSeries::onHovered(bool status, QBoxSet *boxset)
++ {
++ emit hovered(status, qobject_cast<DeclarativeBoxSet *>(boxset));
++ }
++
++ void DeclarativeBoxPlotSeries::onClicked(QBoxSet *boxset)
++ {
++ emit clicked(qobject_cast<DeclarativeBoxSet *>(boxset));
++ }
++
++ void DeclarativeBoxPlotSeries::onPressed(QBoxSet *boxset)
++ {
++ emit pressed(qobject_cast<DeclarativeBoxSet *>(boxset));
++ }
++
++ void DeclarativeBoxPlotSeries::onReleased(QBoxSet *boxset)
++ {
++ emit released(qobject_cast<DeclarativeBoxSet *>(boxset));
++ }
++
++ void DeclarativeBoxPlotSeries::onDoubleClicked(QBoxSet *boxset)
++ {
++ emit doubleClicked(qobject_cast<DeclarativeBoxSet *>(boxset));
++ }
++
++ QString DeclarativeBoxPlotSeries::brushFilename() const
++ {
++ return m_brushFilename;
++ }
++
++ void DeclarativeBoxPlotSeries::setBrushFilename(const QString &brushFilename)
++ {
++ QImage brushImage(brushFilename);
++ if (QBoxPlotSeries::brush().textureImage() != brushImage) {
++ QBrush brush = QBoxPlotSeries::brush();
++ brush.setTextureImage(brushImage);
++ QBoxPlotSeries::setBrush(brush);
++ m_brushFilename = brushFilename;
++ m_brushImage = brushImage;
++ emit brushFilenameChanged(brushFilename);
++ }
++ }
++
++ void DeclarativeBoxPlotSeries::handleBrushChanged()
++ {
++ // If the texture image of the brush has changed along the brush
++ // the brush file name needs to be cleared.
++ if (!m_brushFilename.isEmpty() && QBoxPlotSeries::brush().textureImage() != m_brushImage) {
++ m_brushFilename.clear();
++ emit brushFilenameChanged(QString());
++ }
++ }
++
++ QT_END_NAMESPACE
++
++ #include "moc_declarativeboxplotseries_p.cpp"