qboxset.cpp
569 lines
| 14.3 KiB
| text/x-c
|
CppLexer
Mika Salmela
|
r2486 | /**************************************************************************** | ||
** | ||||
** Copyright (C) 2013 Digia Plc | ||||
** All rights reserved. | ||||
** For any questions to Digia, please use contact form at http://qt.digia.com | ||||
** | ||||
** This file is part of the Qt Commercial Charts Add-on. | ||||
** | ||||
** $QT_BEGIN_LICENSE$ | ||||
** Licensees holding valid Qt Commercial licenses may use this file in | ||||
** accordance with the Qt Commercial License Agreement provided with the | ||||
** Software or, alternatively, in accordance with the terms contained in | ||||
** a written agreement between you and Digia. | ||||
** | ||||
** If you have questions regarding the use of this file, please use | ||||
** contact form at http://qt.digia.com | ||||
** $QT_END_LICENSE$ | ||||
** | ||||
****************************************************************************/ | ||||
#include "qboxset.h" | ||||
#include "qboxset_p.h" | ||||
#include "charthelpers_p.h" | ||||
Mika Salmela
|
r2508 | #include <QDebug> //TODO: remove on release | ||
Mika Salmela
|
r2486 | QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||
/*! | ||||
Mika Salmela
|
r2517 | \class QBoxSet | ||
\brief Building block for box-and-whiskers chart | ||||
QBoxSet represents one box-and-whiskers item. It takes fives values to create a graphical representation | ||||
of range and three medians. There's two type of methods to give the values. The first one is with constructor | ||||
Mika Salmela
|
r2531 | or append type of methods (append and operator <<). The values have to be given in order lower extreme, | ||
Mika Salmela
|
r2517 | lower quartile, median, upper quartile and upper extre. Second method is to create an empty QBoxSet instance and | ||
Mika Salmela
|
r2531 | give the values using value specific methods. | ||
Mika Salmela
|
r2517 | |||
\mainclass | ||||
\sa QBoxPlotSeries | ||||
*/ | ||||
/*! | ||||
\qmlclass BoxSet QBoxSet | ||||
BoxSet represents one box-and-whiskers item. It takes fives values to create a graphical representation | ||||
of range and three medians. There's two type of methods to give the values. The first one is with constructor | ||||
Mika Salmela
|
r2531 | or with append method. In these the values have to be given in order lower extreme, lower quartile, median, | ||
upper quartile and upper extre. Second method is to create an empty QBoxSet instance and | ||||
give the values using value specific methods. | ||||
Mika Salmela
|
r2517 | \sa BoxPlotSeries | ||
*/ | ||||
Mika Salmela
|
r2531 | /*! | ||
\qmlproperty string BoxSet::label | ||||
Defines the label of the boxSet. | ||||
*/ | ||||
/*! | ||||
\qmlproperty int BoxSet::count | ||||
The count of values on the box-and-whiskers set | ||||
*/ | ||||
Mika Salmela
|
r2517 | |||
/*! | ||||
\property QBoxSet::pen | ||||
\brief Defines the pen used by the box-and-whiskers set. | ||||
*/ | ||||
/*! | ||||
\property QBoxSet::brush | ||||
\brief Defines the brush used by the box-and-whiskers set. | ||||
*/ | ||||
/*! | ||||
\property QBoxSet::color | ||||
The fill (brush) color of the box-and-whiskers set. | ||||
*/ | ||||
Mika Salmela
|
r2531 | /*! | ||
\qmlproperty color BoxSet::color | ||||
Defines the fill (brush) color of the box-and-whiskers set. | ||||
*/ | ||||
Mika Salmela
|
r2517 | /*! | ||
\property QBoxSet::borderColor | ||||
The line (pen) color of the box-and-whiskers set. | ||||
*/ | ||||
Mika Salmela
|
r2531 | /*! | ||
\qmlproperty color BoxSet::borderColor | ||||
Defines the outline color of the box-and-whiskers set. | ||||
*/ | ||||
/*! | ||||
\qmlproperty qreal BoxSet::lowerExtreme | ||||
The lower extreme value of the box-and-whiskers set | ||||
*/ | ||||
/*! | ||||
\qmlproperty qreal BoxSet::lowerQuartile | ||||
The lower quartile value of the box-and-whiskers set | ||||
*/ | ||||
/*! | ||||
\qmlproperty qreal BoxSet::median | ||||
The median value of the box-and-whiskers set | ||||
*/ | ||||
/*! | ||||
\qmlproperty qreal BoxSet::upperQuartile | ||||
The upper quartile value of the box-and-whiskers set | ||||
*/ | ||||
/*! | ||||
\qmlproperty qreal BoxSet::upperExtreme | ||||
The upper extreme value of the box-and-whiskers set | ||||
*/ | ||||
Mika Salmela
|
r2517 | |||
/*! | ||||
\fn void QBoxSet::clicked() | ||||
The signal is emitted if the user clicks with a mouse on top of box-and-whisker item. | ||||
*/ | ||||
Mika Salmela
|
r2531 | /*! | ||
\qmlsignal BoxSet::onClicked() | ||||
This signal is emitted when the user clicks with a mouse on top of box-and-whisker item. | ||||
*/ | ||||
Mika Salmela
|
r2517 | |||
/*! | ||||
\fn void QBoxSet::hovered(bool status) | ||||
The signal is emitted if mouse is hovered on top of box-and-whisker item. | ||||
Parameter \a status is true, if mouse entered on top of item, false if mouse left from top of item. | ||||
*/ | ||||
Mika Salmela
|
r2531 | /*! | ||
\qmlsignal BoxSet::onHovered(bool status) | ||||
The signal is emitted if mouse is hovered on top of box-and-whisker item. | ||||
Parameter \a status is true, if mouse entered on top of item, false if mouse left from top of item. | ||||
*/ | ||||
Mika Salmela
|
r2517 | |||
/*! | ||||
\fn void QBoxSet::penChanged() | ||||
This signal is emitted when the pen of the box-and-whisker item has changed. | ||||
\sa pen | ||||
*/ | ||||
Mika Salmela
|
r2531 | /*! | ||
\qmlsignal BoxSet::onPenChanged() | ||||
This signal is emitted when the pen of the box-and-whisker item has changed. | ||||
*/ | ||||
Mika Salmela
|
r2517 | /*! | ||
\fn void QBoxSet::brushChanged() | ||||
This signal is emitted when the brush of the box-and-whisker item has changed. | ||||
\sa brush | ||||
*/ | ||||
Mika Salmela
|
r2531 | /*! | ||
\qmlsignal BoxSet::onBrushChanged() | ||||
This signal is emitted when the brush of the box-and-whisker item has changed. | ||||
*/ | ||||
Mika Salmela
|
r2517 | |||
/*! | ||||
\fn void QBoxSet::colorChanged(QColor) | ||||
This signal is emitted when the fill (brush) color of the box-and-whisker item has changed to \a color. | ||||
*/ | ||||
Mika Salmela
|
r2531 | /*! | ||
\qmlsignal BoxSet::onColorChanged(QColor color) | ||||
This signal is emitted when the fill (brush) color of the box-and-whisker item has changed to \a color. | ||||
*/ | ||||
Mika Salmela
|
r2517 | |||
/*! | ||||
\fn void QBoxSet::valuesAdded(int index, int count) | ||||
This signal is emitted when new values have been added to the box-and-whisker item. | ||||
Parameter \a index indicates the position of the first inserted value. | ||||
Parameter \a count is the number of inserted values. | ||||
\sa append(), insert() | ||||
*/ | ||||
Mika Salmela
|
r2531 | /*! | ||
\qmlsignal BoxSet::onValuesAdded(int index, int count) | ||||
This signal is emitted when new values have been added to the box-and-whisker item. | ||||
Parameter \a index indicates the position of the first inserted value. | ||||
Parameter \a count is the number of inserted values. | ||||
*/ | ||||
Mika Salmela
|
r2517 | |||
/*! | ||||
\fn void QBoxSet::valueChanged(int index) | ||||
This signal is emitted values the value in the box-and-whisker item has been modified. | ||||
Parameter \a index indicates the position of the modified value. | ||||
\sa at() | ||||
*/ | ||||
Mika Salmela
|
r2531 | /*! | ||
\qmlsignal BoxSet::onValueChanged(int index) | ||||
This signal is emitted values the value in the box-and-whisker item has been modified. | ||||
Parameter \a index indicates the position of the modified value. | ||||
*/ | ||||
Mika Salmela
|
r2517 | /*! | ||
\fn void QBoxSet::borderColorChanged(QColor) | ||||
This signal is emitted when the line (pen) color of the box-and-whisker item has changed to \a color. | ||||
*/ | ||||
Mika Salmela
|
r2531 | /*! | ||
\qmlsignal BoxSet::onBorderColorChanged(QColor color) | ||||
This signal is emitted when the line (pen) color of the box-and-whisker item has changed to \a color. | ||||
*/ | ||||
Mika Salmela
|
r2517 | |||
/*! | ||||
Constructs QBoxSet with optional \a label and parent of \a parent | ||||
Mika Salmela
|
r2486 | */ | ||
Mika Salmela
|
r2513 | QBoxSet::QBoxSet(const QString label, QObject *parent) | ||
Mika Salmela
|
r2486 | : QObject(parent), | ||
Mika Salmela
|
r2513 | d_ptr(new QBoxSetPrivate(label, this)) | ||
Mika Salmela
|
r2486 | { | ||
} | ||||
Mika Salmela
|
r2517 | /*! | ||
Constructs QBoxSet with given ordered values. \a le for lower extreme, \a lq for lower quartile, \a m for median, | ||||
\a uq for upper quartile and \a ue for upper quartile. \a label and \a parent are optional. | ||||
*/ | ||||
Mika Salmela
|
r2518 | QBoxSet::QBoxSet(const qreal le, const qreal lq, const qreal m, const qreal uq, const qreal ue, const QString label, QObject *parent) | ||
Mika Salmela
|
r2486 | : QObject(parent), | ||
Mika Salmela
|
r2513 | d_ptr(new QBoxSetPrivate(label, this)) | ||
Mika Salmela
|
r2486 | { | ||
Mika Salmela
|
r2517 | d_ptr->append(le); | ||
d_ptr->append(lq); | ||||
d_ptr->append(m); | ||||
d_ptr->append(uq); | ||||
d_ptr->append(ue); | ||||
Mika Salmela
|
r2486 | } | ||
/*! | ||||
Destroys the boxset | ||||
*/ | ||||
QBoxSet::~QBoxSet() | ||||
{ | ||||
// NOTE: d_ptr destroyed by QObject | ||||
} | ||||
/*! | ||||
Appends new value \a value to the end of set. | ||||
*/ | ||||
void QBoxSet::append(const qreal value) | ||||
{ | ||||
Mika Salmela
|
r2508 | //int index = d_ptr->m_values.count(); | ||
Mika Salmela
|
r2486 | d_ptr->append(value); | ||
Mika Salmela
|
r2508 | emit valuesAdded(d_ptr->m_valuesCount, 1); | ||
Mika Salmela
|
r2486 | } | ||
/*! | ||||
Appends a list of reals to set. Works like append with single real value. The \a values in list | ||||
are appended to end of boxset | ||||
\sa append() | ||||
*/ | ||||
void QBoxSet::append(const QList<qreal> &values) | ||||
{ | ||||
Mika Salmela
|
r2508 | //int index = d_ptr->m_values.count(); | ||
Mika Salmela
|
r2486 | d_ptr->append(values); | ||
Mika Salmela
|
r2508 | emit valuesAdded(d_ptr->m_valuesCount, values.count()); | ||
Mika Salmela
|
r2486 | } | ||
/*! | ||||
Sets new value \a value as the lower extreme for the set. | ||||
*/ | ||||
void QBoxSet::setLowerExtreme(const qreal value) | ||||
{ | ||||
d_ptr->replace(QBoxSetPrivate::PosLowerExtreme, value); | ||||
Mika Salmela
|
r2508 | emit d_ptr->restructuredBox(); | ||
Mika Salmela
|
r2486 | emit valueChanged(QBoxSetPrivate::PosLowerExtreme); | ||
} | ||||
/*! | ||||
Returns the lower extreme value of the set. | ||||
*/ | ||||
qreal QBoxSet::lowerExtreme() | ||||
{ | ||||
Mika Salmela
|
r2508 | return d_ptr->m_values[QBoxSetPrivate::PosLowerExtreme]; | ||
Mika Salmela
|
r2486 | } | ||
/*! | ||||
Sets new value \a value as the lower quartile for the set. | ||||
*/ | ||||
void QBoxSet::setLowerQuartile(const qreal value) | ||||
{ | ||||
d_ptr->replace(QBoxSetPrivate::PosLowerQuartile, value); | ||||
Mika Salmela
|
r2508 | emit d_ptr->restructuredBox(); | ||
Mika Salmela
|
r2486 | emit valueChanged(QBoxSetPrivate::PosLowerQuartile); | ||
} | ||||
/*! | ||||
Returns the lower quartile value of the set. | ||||
*/ | ||||
qreal QBoxSet::lowerQuartile() | ||||
{ | ||||
Mika Salmela
|
r2508 | return d_ptr->m_values[QBoxSetPrivate::PosLowerQuartile]; | ||
Mika Salmela
|
r2486 | } | ||
/*! | ||||
Sets new value \a value as the median for the set. | ||||
*/ | ||||
void QBoxSet::setMedian(const qreal value) | ||||
{ | ||||
d_ptr->replace(QBoxSetPrivate::PosMedian, value); | ||||
Mika Salmela
|
r2508 | emit d_ptr->restructuredBox(); | ||
Mika Salmela
|
r2486 | emit valueChanged(QBoxSetPrivate::PosMedian); | ||
} | ||||
/*! | ||||
Returns the median value of the set. | ||||
*/ | ||||
qreal QBoxSet::median() | ||||
{ | ||||
Mika Salmela
|
r2508 | return d_ptr->m_values[QBoxSetPrivate::PosMedian]; | ||
Mika Salmela
|
r2486 | } | ||
/*! | ||||
Sets new value \a value as the upper quartile for the set. | ||||
*/ | ||||
void QBoxSet::setUpperQuartile(const qreal value) | ||||
{ | ||||
d_ptr->replace(QBoxSetPrivate::PosUpperQuartile, value); | ||||
Mika Salmela
|
r2508 | emit d_ptr->restructuredBox(); | ||
Mika Salmela
|
r2486 | emit valueChanged(QBoxSetPrivate::PosUpperQuartile); | ||
} | ||||
/*! | ||||
Returns the upper quartile value of the set. | ||||
*/ | ||||
qreal QBoxSet::upperQuartile() | ||||
{ | ||||
Mika Salmela
|
r2508 | return d_ptr->m_values[QBoxSetPrivate::PosUpperQuartile]; | ||
Mika Salmela
|
r2486 | } | ||
/*! | ||||
Sets new value \a value as the upper extreme for the set. | ||||
*/ | ||||
void QBoxSet::setUpperExtreme(const qreal value) | ||||
{ | ||||
Mika Salmela
|
r2508 | d_ptr->replace(QBoxSetPrivate::PosUpperExtreme, value); | ||
emit d_ptr->restructuredBox(); | ||||
emit valueChanged(QBoxSetPrivate::PosUpperExtreme); | ||||
Mika Salmela
|
r2486 | } | ||
/*! | ||||
Returns the upper extreme value of the set. | ||||
*/ | ||||
qreal QBoxSet::upperExtreme() | ||||
{ | ||||
Mika Salmela
|
r2508 | return d_ptr->m_values[QBoxSetPrivate::PosUpperExtreme]; | ||
Mika Salmela
|
r2486 | } | ||
Mika Salmela
|
r2513 | /*! | ||
Sets new \a label for set. | ||||
*/ | ||||
void QBoxSet::setLabel(const QString label) | ||||
{ | ||||
d_ptr->m_label = label; | ||||
} | ||||
/*! | ||||
Returns label of the set. | ||||
*/ | ||||
QString QBoxSet::label() const | ||||
{ | ||||
return d_ptr->m_label; | ||||
} | ||||
Mika Salmela
|
r2486 | /*! | ||
Convenience operator. Same as append, with real \a value. | ||||
\sa append() | ||||
*/ | ||||
QBoxSet &QBoxSet::operator << (const qreal &value) | ||||
{ | ||||
append(value); | ||||
return *this; | ||||
} | ||||
/*! | ||||
Inserts new \a value on the \a index position. | ||||
The value that is currently at this postion is moved to postion index + 1 | ||||
*/ | ||||
void QBoxSet::insert(const int index, const qreal value) | ||||
{ | ||||
d_ptr->insert(index, value); | ||||
emit valuesAdded(index, 1); | ||||
} | ||||
/*! | ||||
Sets a new value \a value to set, indexed by \a index | ||||
*/ | ||||
void QBoxSet::replace(const int index, const qreal value) | ||||
{ | ||||
Mika Salmela
|
r2508 | if (index >= 0 && index < 5) { | ||
Mika Salmela
|
r2486 | d_ptr->replace(index, value); | ||
emit valueChanged(index); | ||||
} | ||||
} | ||||
/*! | ||||
Returns value of set indexed by \a index. | ||||
If the index is out of bounds 0.0 is returned. | ||||
*/ | ||||
qreal QBoxSet::at(const int index) const | ||||
{ | ||||
Mika Salmela
|
r2508 | if (index < 0 || index >= 5) | ||
Mika Salmela
|
r2486 | return 0; | ||
Mika Salmela
|
r2508 | return d_ptr->m_values[index]; | ||
Mika Salmela
|
r2486 | } | ||
/*! | ||||
Returns value of set indexed by \a index. | ||||
If the index is out of bounds 0.0 is returned. | ||||
*/ | ||||
qreal QBoxSet::operator [](const int index) const | ||||
{ | ||||
return at(index); | ||||
} | ||||
/*! | ||||
Returns count of values in set. | ||||
*/ | ||||
int QBoxSet::count() const | ||||
{ | ||||
Mika Salmela
|
r2508 | return d_ptr->m_valuesCount; | ||
Mika Salmela
|
r2486 | } | ||
/*! | ||||
Sets pen for set. Boxes of this set are drawn using \a pen | ||||
*/ | ||||
void QBoxSet::setPen(const QPen &pen) | ||||
{ | ||||
if (d_ptr->m_pen != pen) { | ||||
d_ptr->m_pen = pen; | ||||
emit d_ptr->updatedBox(); | ||||
emit penChanged(); | ||||
} | ||||
} | ||||
/*! | ||||
Returns pen of the set. | ||||
*/ | ||||
QPen QBoxSet::pen() const | ||||
{ | ||||
return d_ptr->m_pen; | ||||
} | ||||
/*! | ||||
Sets brush for the set. Boxes of this set are drawn using \a brush | ||||
*/ | ||||
void QBoxSet::setBrush(const QBrush &brush) | ||||
{ | ||||
if (d_ptr->m_brush != brush) { | ||||
d_ptr->m_brush = brush; | ||||
emit d_ptr->updatedBox(); | ||||
emit brushChanged(); | ||||
} | ||||
} | ||||
/*! | ||||
Returns brush of the set. | ||||
*/ | ||||
QBrush QBoxSet::brush() const | ||||
{ | ||||
return d_ptr->m_brush; | ||||
} | ||||
/*! | ||||
Returns the color of the brush of boxset. | ||||
*/ | ||||
QColor QBoxSet::color() | ||||
{ | ||||
return brush().color(); | ||||
} | ||||
/*! | ||||
Sets the \a color of brush for this boxset | ||||
*/ | ||||
void QBoxSet::setColor(QColor color) | ||||
{ | ||||
QBrush b = brush(); | ||||
if ((b.color() != color) || (b.style() == Qt::NoBrush)) { | ||||
b.setColor(color); | ||||
if (b.style() == Qt::NoBrush) { | ||||
// Set tyle to Qt::SolidPattern. (Default is Qt::NoBrush) | ||||
// This prevents theme to override color defined in QML side: | ||||
// BoxSet { label: "Bob"; color:"red"; values: [1,2,3] } | ||||
// The color must be obeyed, since user wanted it. | ||||
b.setStyle(Qt::SolidPattern); | ||||
} | ||||
setBrush(b); | ||||
emit colorChanged(color); | ||||
} | ||||
} | ||||
/*! | ||||
Returns the color of pen of this boxset | ||||
*/ | ||||
QColor QBoxSet::borderColor() | ||||
{ | ||||
return pen().color(); | ||||
} | ||||
/*! | ||||
Sets the color of pen for this boxset | ||||
*/ | ||||
void QBoxSet::setBorderColor(QColor color) | ||||
{ | ||||
QPen p = pen(); | ||||
if (p.color() != color) { | ||||
p.setColor(color); | ||||
Mika Salmela
|
r2531 | p.setStyle(Qt::SolidLine); | ||
Mika Salmela
|
r2486 | setPen(p); | ||
emit borderColorChanged(color); | ||||
} | ||||
} | ||||
//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||||
Mika Salmela
|
r2513 | QBoxSetPrivate::QBoxSetPrivate(const QString label, QBoxSet *parent) : QObject(parent), | ||
Mika Salmela
|
r2486 | q_ptr(parent), | ||
Mika Salmela
|
r2513 | m_label(label), | ||
Mika Salmela
|
r2508 | m_valuesCount(5), | ||
m_appendCount(0), | ||||
Mika Salmela
|
r2486 | m_pen(QPen(Qt::NoPen)), | ||
m_brush(QBrush(Qt::NoBrush)) | ||||
{ | ||||
Mika Salmela
|
r2508 | m_values = new qreal[m_valuesCount]; | ||
Mika Salmela
|
r2486 | } | ||
QBoxSetPrivate::~QBoxSetPrivate() | ||||
{ | ||||
} | ||||
void QBoxSetPrivate::append(qreal value) | ||||
{ | ||||
Mika Salmela
|
r2508 | if (isValidValue(value) && m_appendCount < m_valuesCount) { | ||
m_values[m_appendCount++] = value; | ||||
Mika Salmela
|
r2486 | emit restructuredBox(); | ||
} | ||||
} | ||||
void QBoxSetPrivate::append(QList<qreal> values) | ||||
{ | ||||
for (int i = 0; i < values.count(); i++) { | ||||
Mika Salmela
|
r2508 | if (isValidValue(values.at(i)) && m_appendCount < m_valuesCount) | ||
m_values[m_appendCount++] = values.at(i); | ||||
Mika Salmela
|
r2486 | } | ||
emit restructuredBox(); | ||||
} | ||||
void QBoxSetPrivate::insert(const int index, const qreal value) | ||||
{ | ||||
if (isValidValue(value)) { | ||||
Mika Salmela
|
r2508 | for (int i = 4; i > index; i--) | ||
m_values[i] = m_values[i - 1]; | ||||
m_values[index] = value; | ||||
Mika Salmela
|
r2486 | emit restructuredBox(); | ||
} | ||||
} | ||||
void QBoxSetPrivate::replace(const int index, const qreal value) | ||||
{ | ||||
Mika Salmela
|
r2508 | m_values[index] = value; | ||
Mika Salmela
|
r2486 | emit updatedLayout(); | ||
} | ||||
qreal QBoxSetPrivate::value(const int index) | ||||
{ | ||||
Mika Salmela
|
r2508 | if (index < 0 || index >= m_valuesCount) | ||
Mika Salmela
|
r2486 | return 0; | ||
Mika Salmela
|
r2508 | return m_values[index]; | ||
Mika Salmela
|
r2486 | } | ||
#include "moc_qboxset.cpp" | ||||
#include "moc_qboxset_p.cpp" | ||||
QTCOMMERCIALCHART_END_NAMESPACE | ||||