##// END OF EJS Templates
Documentation and fix for box specific pen color...
Documentation and fix for box specific pen color Change-Id: I88919b60a17665b01bda979b576878c30abd50fd Reviewed-by: Mika Salmela <mika.salmela@digia.com>

File last commit:

r2531:baa389f1ece6
r2531:baa389f1ece6
Show More
qboxset.cpp
569 lines | 14.3 KiB | text/x-c | CppLexer
Mika Salmela
Created own boxset class...
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
QBoxSet changed from list to table mode. New example for file reading....
r2508 #include <QDebug> //TODO: remove on release
Mika Salmela
Created own boxset class...
r2486 QTCOMMERCIALCHART_BEGIN_NAMESPACE
/*!
Mika Salmela
Documentation...
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
Documentation and fix for box specific pen color...
r2531 or append type of methods (append and operator <<). The values have to be given in order lower extreme,
Mika Salmela
Documentation...
r2517 lower quartile, median, upper quartile and upper extre. Second method is to create an empty QBoxSet instance and
Mika Salmela
Documentation and fix for box specific pen color...
r2531 give the values using value specific methods.
Mika Salmela
Documentation...
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
Documentation and fix for box specific pen color...
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
Documentation...
r2517 \sa BoxPlotSeries
*/
Mika Salmela
Documentation and fix for box specific pen color...
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
Documentation...
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
Documentation and fix for box specific pen color...
r2531 /*!
\qmlproperty color BoxSet::color
Defines the fill (brush) color of the box-and-whiskers set.
*/
Mika Salmela
Documentation...
r2517 /*!
\property QBoxSet::borderColor
The line (pen) color of the box-and-whiskers set.
*/
Mika Salmela
Documentation and fix for box specific pen color...
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
Documentation...
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
Documentation and fix for box specific pen color...
r2531 /*!
\qmlsignal BoxSet::onClicked()
This signal is emitted when the user clicks with a mouse on top of box-and-whisker item.
*/
Mika Salmela
Documentation...
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
Documentation and fix for box specific pen color...
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
Documentation...
r2517
/*!
\fn void QBoxSet::penChanged()
This signal is emitted when the pen of the box-and-whisker item has changed.
\sa pen
*/
Mika Salmela
Documentation and fix for box specific pen color...
r2531 /*!
\qmlsignal BoxSet::onPenChanged()
This signal is emitted when the pen of the box-and-whisker item has changed.
*/
Mika Salmela
Documentation...
r2517 /*!
\fn void QBoxSet::brushChanged()
This signal is emitted when the brush of the box-and-whisker item has changed.
\sa brush
*/
Mika Salmela
Documentation and fix for box specific pen color...
r2531 /*!
\qmlsignal BoxSet::onBrushChanged()
This signal is emitted when the brush of the box-and-whisker item has changed.
*/
Mika Salmela
Documentation...
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
Documentation and fix for box specific pen color...
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
Documentation...
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
Documentation and fix for box specific pen color...
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
Documentation...
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
Documentation and fix for box specific pen color...
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
Documentation...
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
Documentation and fix for box specific pen color...
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
Documentation...
r2517
/*!
Constructs QBoxSet with optional \a label and parent of \a parent
Mika Salmela
Created own boxset class...
r2486 */
Mika Salmela
Added label to boxset...
r2513 QBoxSet::QBoxSet(const QString label, QObject *parent)
Mika Salmela
Created own boxset class...
r2486 : QObject(parent),
Mika Salmela
Added label to boxset...
r2513 d_ptr(new QBoxSetPrivate(label, this))
Mika Salmela
Created own boxset class...
r2486 {
}
Mika Salmela
Documentation...
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
Fix...
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
Created own boxset class...
r2486 : QObject(parent),
Mika Salmela
Added label to boxset...
r2513 d_ptr(new QBoxSetPrivate(label, this))
Mika Salmela
Created own boxset class...
r2486 {
Mika Salmela
Documentation...
r2517 d_ptr->append(le);
d_ptr->append(lq);
d_ptr->append(m);
d_ptr->append(uq);
d_ptr->append(ue);
Mika Salmela
Created own boxset class...
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
QBoxSet changed from list to table mode. New example for file reading....
r2508 //int index = d_ptr->m_values.count();
Mika Salmela
Created own boxset class...
r2486 d_ptr->append(value);
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 emit valuesAdded(d_ptr->m_valuesCount, 1);
Mika Salmela
Created own boxset class...
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
QBoxSet changed from list to table mode. New example for file reading....
r2508 //int index = d_ptr->m_values.count();
Mika Salmela
Created own boxset class...
r2486 d_ptr->append(values);
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 emit valuesAdded(d_ptr->m_valuesCount, values.count());
Mika Salmela
Created own boxset class...
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
QBoxSet changed from list to table mode. New example for file reading....
r2508 emit d_ptr->restructuredBox();
Mika Salmela
Created own boxset class...
r2486 emit valueChanged(QBoxSetPrivate::PosLowerExtreme);
}
/*!
Returns the lower extreme value of the set.
*/
qreal QBoxSet::lowerExtreme()
{
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 return d_ptr->m_values[QBoxSetPrivate::PosLowerExtreme];
Mika Salmela
Created own boxset class...
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
QBoxSet changed from list to table mode. New example for file reading....
r2508 emit d_ptr->restructuredBox();
Mika Salmela
Created own boxset class...
r2486 emit valueChanged(QBoxSetPrivate::PosLowerQuartile);
}
/*!
Returns the lower quartile value of the set.
*/
qreal QBoxSet::lowerQuartile()
{
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 return d_ptr->m_values[QBoxSetPrivate::PosLowerQuartile];
Mika Salmela
Created own boxset class...
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
QBoxSet changed from list to table mode. New example for file reading....
r2508 emit d_ptr->restructuredBox();
Mika Salmela
Created own boxset class...
r2486 emit valueChanged(QBoxSetPrivate::PosMedian);
}
/*!
Returns the median value of the set.
*/
qreal QBoxSet::median()
{
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 return d_ptr->m_values[QBoxSetPrivate::PosMedian];
Mika Salmela
Created own boxset class...
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
QBoxSet changed from list to table mode. New example for file reading....
r2508 emit d_ptr->restructuredBox();
Mika Salmela
Created own boxset class...
r2486 emit valueChanged(QBoxSetPrivate::PosUpperQuartile);
}
/*!
Returns the upper quartile value of the set.
*/
qreal QBoxSet::upperQuartile()
{
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 return d_ptr->m_values[QBoxSetPrivate::PosUpperQuartile];
Mika Salmela
Created own boxset class...
r2486 }
/*!
Sets new value \a value as the upper extreme for the set.
*/
void QBoxSet::setUpperExtreme(const qreal value)
{
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 d_ptr->replace(QBoxSetPrivate::PosUpperExtreme, value);
emit d_ptr->restructuredBox();
emit valueChanged(QBoxSetPrivate::PosUpperExtreme);
Mika Salmela
Created own boxset class...
r2486 }
/*!
Returns the upper extreme value of the set.
*/
qreal QBoxSet::upperExtreme()
{
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 return d_ptr->m_values[QBoxSetPrivate::PosUpperExtreme];
Mika Salmela
Created own boxset class...
r2486 }
Mika Salmela
Added label to boxset...
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
Created own boxset class...
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
QBoxSet changed from list to table mode. New example for file reading....
r2508 if (index >= 0 && index < 5) {
Mika Salmela
Created own boxset class...
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
QBoxSet changed from list to table mode. New example for file reading....
r2508 if (index < 0 || index >= 5)
Mika Salmela
Created own boxset class...
r2486 return 0;
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 return d_ptr->m_values[index];
Mika Salmela
Created own boxset class...
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
QBoxSet changed from list to table mode. New example for file reading....
r2508 return d_ptr->m_valuesCount;
Mika Salmela
Created own boxset class...
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
Documentation and fix for box specific pen color...
r2531 p.setStyle(Qt::SolidLine);
Mika Salmela
Created own boxset class...
r2486 setPen(p);
emit borderColorChanged(color);
}
}
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
Mika Salmela
Added label to boxset...
r2513 QBoxSetPrivate::QBoxSetPrivate(const QString label, QBoxSet *parent) : QObject(parent),
Mika Salmela
Created own boxset class...
r2486 q_ptr(parent),
Mika Salmela
Added label to boxset...
r2513 m_label(label),
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 m_valuesCount(5),
m_appendCount(0),
Mika Salmela
Created own boxset class...
r2486 m_pen(QPen(Qt::NoPen)),
m_brush(QBrush(Qt::NoBrush))
{
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 m_values = new qreal[m_valuesCount];
Mika Salmela
Created own boxset class...
r2486 }
QBoxSetPrivate::~QBoxSetPrivate()
{
}
void QBoxSetPrivate::append(qreal value)
{
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 if (isValidValue(value) && m_appendCount < m_valuesCount) {
m_values[m_appendCount++] = value;
Mika Salmela
Created own boxset class...
r2486 emit restructuredBox();
}
}
void QBoxSetPrivate::append(QList<qreal> values)
{
for (int i = 0; i < values.count(); i++) {
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 if (isValidValue(values.at(i)) && m_appendCount < m_valuesCount)
m_values[m_appendCount++] = values.at(i);
Mika Salmela
Created own boxset class...
r2486 }
emit restructuredBox();
}
void QBoxSetPrivate::insert(const int index, const qreal value)
{
if (isValidValue(value)) {
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 for (int i = 4; i > index; i--)
m_values[i] = m_values[i - 1];
m_values[index] = value;
Mika Salmela
Created own boxset class...
r2486 emit restructuredBox();
}
}
void QBoxSetPrivate::replace(const int index, const qreal value)
{
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 m_values[index] = value;
Mika Salmela
Created own boxset class...
r2486 emit updatedLayout();
}
qreal QBoxSetPrivate::value(const int index)
{
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 if (index < 0 || index >= m_valuesCount)
Mika Salmela
Created own boxset class...
r2486 return 0;
Mika Salmela
QBoxSet changed from list to table mode. New example for file reading....
r2508 return m_values[index];
Mika Salmela
Created own boxset class...
r2486 }
#include "moc_qboxset.cpp"
#include "moc_qboxset_p.cpp"
QTCOMMERCIALCHART_END_NAMESPACE