qbarset.cpp
342 lines
| 8.3 KiB
| text/x-c
|
CppLexer
Jani Honkonen
|
r794 | /**************************************************************************** | ||
| ** | ||||
| ** Copyright (C) 2012 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$ | ||||
| ** | ||||
| ****************************************************************************/ | ||||
sauimone
|
r169 | #include "qbarset.h" | ||
Michal Klocek
|
r938 | #include "qbarset_p.h" | ||
|
sauimone
|
r169 | |||
| QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||||
|
sauimone
|
r313 | /*! | ||
| \class QBarSet | ||||
| \brief part of QtCommercial chart API. | ||||
| QBarSet represents one set of bars. Set of bars contains one data value for each category. | ||||
| First value of set is assumed to belong to first category, second to second category and so on. | ||||
| If set has fewer values than there are categories, then the missing values are assumed to be | ||||
| at the end of set. For missing values in middle of a set, numerical value of zero is used. | ||||
|
sauimone
|
r325 | \mainclass | ||
|
sauimone
|
r1208 | \sa QBarSeries, QGroupedBarSeries, QStackedBarSeries, QPercentBarSeries | ||
|
sauimone
|
r313 | */ | ||
| /*! | ||||
|
sauimone
|
r1008 | \fn void QBarSet::clicked(QString category) | ||
|
sauimone
|
r313 | \brief signals that set has been clicked | ||
|
sauimone
|
r425 | Parameter \a category describes on which category was clicked | ||
|
sauimone
|
r980 | */ | ||
|
sauimone
|
r975 | /*! | ||
| \fn void QBarSet::hovered(bool status) | ||||
| \brief signals that mouse has hovered over the set. If \a status is true, then mouse was entered. If \a status is false, then mouse was left. | ||||
|
sauimone
|
r980 | |||
| The signal is emitted if mouse is hovered on top of set | ||||
| Parameter \a status is true, if mouse entered on top of series, false if mouse left from top of series. | ||||
|
sauimone
|
r975 | */ | ||
|
sauimone
|
r313 | /*! | ||
| Constructs QBarSet with a name of \a name and with parent of \a parent | ||||
| */ | ||||
|
sauimone
|
r993 | QBarSet::QBarSet(const QString name, QObject *parent) | ||
|
sauimone
|
r276 | : QObject(parent) | ||
|
sauimone
|
r934 | ,d_ptr(new QBarSetPrivate(name,this)) | ||
|
sauimone
|
r169 | { | ||
| } | ||||
|
sauimone
|
r980 | /*! | ||
| Destroys the barset | ||||
| */ | ||||
|
Jani Honkonen
|
r944 | QBarSet::~QBarSet() | ||
| { | ||||
|
sauimone
|
r980 | // NOTE: d_ptr destroyed by QObject | ||
|
Jani Honkonen
|
r944 | } | ||
|
sauimone
|
r313 | /*! | ||
| Sets new \a name for set. | ||||
| */ | ||||
|
sauimone
|
r993 | void QBarSet::setName(const QString name) | ||
|
sauimone
|
r169 | { | ||
|
Michal Klocek
|
r938 | d_ptr->m_name = name; | ||
|
sauimone
|
r169 | } | ||
|
sauimone
|
r313 | |||
| /*! | ||||
| Returns name of the set. | ||||
| */ | ||||
|
sauimone
|
r776 | QString QBarSet::name() const | ||
|
sauimone
|
r171 | { | ||
|
Michal Klocek
|
r938 | return d_ptr->m_name; | ||
|
sauimone
|
r171 | } | ||
|
sauimone
|
r169 | |||
|
sauimone
|
r1208 | /*! | ||
| Appends a point to set. Parameter \a value x coordinate defines the | ||||
| position in x-axis and y coordinate defines the height of bar. | ||||
| Depending on presentation (QBarSeries, QGroupedBarSeries, QStackedBarSeries, QPercentBarSeries) | ||||
| the x values are used or ignored. | ||||
| */ | ||||
|
sauimone
|
r1167 | void QBarSet::append(const QPointF value) | ||
| { | ||||
| d_ptr->m_values.append(value); | ||||
| emit d_ptr->restructuredBars(); | ||||
| } | ||||
|
sauimone
|
r1208 | /*! | ||
|
sauimone
|
r1243 | Appends a list of \a values to set. Works like append with single point. | ||
|
sauimone
|
r1208 | \sa append() | ||
| */ | ||||
|
sauimone
|
r1167 | void QBarSet::append(const QList<QPointF> values) | ||
| { | ||||
| for (int i=0; i<values.count(); i++) { | ||||
| d_ptr->m_values.append(values.at(i)); | ||||
| } | ||||
| emit d_ptr->restructuredBars(); | ||||
| } | ||||
|
sauimone
|
r313 | /*! | ||
|
sauimone
|
r1208 | Appends new value \a value to the end of set. Internally the value is converted to QPointF, | ||
| with x coordinate being the index of appended value and y coordinate is the value. | ||||
|
sauimone
|
r313 | */ | ||
|
sauimone
|
r993 | void QBarSet::append(const qreal value) | ||
|
sauimone
|
r169 | { | ||
|
sauimone
|
r1167 | append(QPointF(d_ptr->m_values.count(), value)); | ||
| } | ||||
|
sauimone
|
r1208 | /*! | ||
| Appends a list of reals to set. Works like append with single real value. The values in list | ||||
| are converted to QPointF, where x coordinate is the index of point and y coordinate is the value. | ||||
| \sa append() | ||||
| */ | ||||
|
sauimone
|
r1167 | void QBarSet::append(const QList<qreal> values) | ||
| { | ||||
| int index = d_ptr->m_values.count(); | ||||
| for (int i=0; i<values.count(); i++) { | ||||
| d_ptr->m_values.append(QPointF(index,values.at(i))); | ||||
| index++; | ||||
| } | ||||
|
sauimone
|
r1008 | emit d_ptr->restructuredBars(); | ||
|
sauimone
|
r993 | } | ||
| /*! | ||||
|
sauimone
|
r1208 | Convinience operator. Same as append, with real \a value. | ||
| \sa append() | ||||
|
sauimone
|
r993 | */ | ||
| QBarSet& QBarSet::operator << (const qreal &value) | ||||
| { | ||||
| append(value); | ||||
|
sauimone
|
r169 | return *this; | ||
| } | ||||
|
sauimone
|
r1208 | /*! | ||
| Convinience operator. Same as append, with QPointF \a value. | ||||
| \sa append() | ||||
| */ | ||||
|
sauimone
|
r1167 | QBarSet& QBarSet::operator << (const QPointF &value) | ||
| { | ||||
| append(value); | ||||
| return *this; | ||||
| } | ||||
Marek Rosa
|
r901 | /*! | ||
|
sauimone
|
r993 | Inserts new \a value on the \a index position. | ||
| The value that is currently at this postion is moved to postion index + 1 | ||||
| \sa remove() | ||||
|
Marek Rosa
|
r901 | */ | ||
|
sauimone
|
r993 | void QBarSet::insert(const int index, const qreal value) | ||
|
Marek Rosa
|
r662 | { | ||
|
sauimone
|
r1167 | d_ptr->m_values.insert(index, QPointF(index, value)); | ||
|
Marek Rosa
|
r1056 | // emit d_ptr->updatedBars(); | ||
|
Marek Rosa
|
r662 | } | ||
|
Marek Rosa
|
r901 | /*! | ||
|
sauimone
|
r993 | Removes the value specified by \a index | ||
| \sa insert() | ||||
|
Marek Rosa
|
r901 | */ | ||
|
sauimone
|
r993 | void QBarSet::remove(const int index) | ||
|
Marek Rosa
|
r663 | { | ||
|
sauimone
|
r993 | d_ptr->m_values.removeAt(index); | ||
|
Marek Rosa
|
r1056 | // emit d_ptr->updatedBars(); | ||
|
Marek Rosa
|
r663 | } | ||
|
sauimone
|
r313 | /*! | ||
|
sauimone
|
r993 | Sets a new value \a value to set, indexed by \a index | ||
|
sauimone
|
r313 | */ | ||
|
sauimone
|
r993 | void QBarSet::replace(const int index, const qreal value) | ||
|
sauimone
|
r171 | { | ||
|
sauimone
|
r1167 | d_ptr->m_values.replace(index,QPointF(index,value)); | ||
|
sauimone
|
r1008 | emit d_ptr->updatedBars(); | ||
|
sauimone
|
r171 | } | ||
|
sauimone
|
r313 | /*! | ||
|
sauimone
|
r1208 | Returns value of set indexed by \a index. Note that all appended values are stored internally as QPointF. | ||
| The returned QPointF has x coordinate, which is index (if appended with qreal append) or the x value | ||||
| of the QPointF (if appended with QPointF append). | ||||
| If the index is out of bounds QPointF(0, 0.0) is returned. | ||||
|
sauimone
|
r313 | */ | ||
|
sauimone
|
r1167 | QPointF QBarSet::at(const int index) const | ||
|
sauimone
|
r171 | { | ||
|
sauimone
|
r1168 | if (index < 0 || index >= d_ptr->m_values.count()) { | ||
| return QPointF(index, 0.0); | ||||
| } | ||||
Tero Ahola
|
r1162 | |||
|
Michal Klocek
|
r938 | return d_ptr->m_values.at(index); | ||
|
sauimone
|
r171 | } | ||
|
sauimone
|
r313 | /*! | ||
|
sauimone
|
r1208 | Returns value of set indexed by \a index. ote that all appended values are stored internally as QPointF. | ||
| The returned QPointF has x coordinate, which is index (if appended with qreal append) or the x value | ||||
| of the QPointF (if appended with QPointF append). | ||||
|
sauimone
|
r313 | */ | ||
|
sauimone
|
r1167 | QPointF QBarSet::operator [](const int index) const | ||
|
sauimone
|
r183 | { | ||
|
sauimone
|
r993 | return d_ptr->m_values.at(index); | ||
| } | ||||
| /*! | ||||
| Returns count of values in set. | ||||
| */ | ||||
| int QBarSet::count() const | ||||
| { | ||||
| return d_ptr->m_values.count(); | ||||
|
sauimone
|
r183 | } | ||
|
sauimone
|
r492 | /*! | ||
|
sauimone
|
r1208 | Returns sum of all values in barset. The sum is sum of y coordinates in the QPointF representation. | ||
|
sauimone
|
r492 | */ | ||
|
sauimone
|
r934 | qreal QBarSet::sum() const | ||
|
sauimone
|
r438 | { | ||
| qreal total(0); | ||||
|
Michal Klocek
|
r938 | for (int i=0; i < d_ptr->m_values.count(); i++) { | ||
|
sauimone
|
r1167 | //total += d_ptr->m_values.at(i); | ||
| total += d_ptr->m_values.at(i).y(); | ||||
|
sauimone
|
r438 | } | ||
| return total; | ||||
| } | ||||
|
sauimone
|
r313 | /*! | ||
| Sets pen for set. Bars of this set are drawn using \a pen | ||||
| */ | ||||
|
sauimone
|
r763 | void QBarSet::setPen(const QPen &pen) | ||
|
sauimone
|
r214 | { | ||
|
Michal Klocek
|
r938 | if(d_ptr->m_pen!=pen){ | ||
| d_ptr->m_pen = pen; | ||||
|
sauimone
|
r1008 | emit d_ptr->updatedBars(); | ||
|
Michal Klocek
|
r938 | } | ||
|
sauimone
|
r214 | } | ||
|
sauimone
|
r313 | /*! | ||
| Returns pen of the set. | ||||
| */ | ||||
|
sauimone
|
r473 | QPen QBarSet::pen() const | ||
|
sauimone
|
r214 | { | ||
|
Michal Klocek
|
r938 | return d_ptr->m_pen; | ||
|
sauimone
|
r214 | } | ||
|
sauimone
|
r313 | /*! | ||
| Sets brush for the set. Bars of this set are drawn using \a brush | ||||
| */ | ||||
|
sauimone
|
r763 | void QBarSet::setBrush(const QBrush &brush) | ||
|
sauimone
|
r214 | { | ||
|
Michal Klocek
|
r938 | if(d_ptr->m_brush!=brush){ | ||
| d_ptr->m_brush = brush; | ||||
|
sauimone
|
r1008 | emit d_ptr->updatedBars(); | ||
|
Michal Klocek
|
r938 | } | ||
|
sauimone
|
r214 | } | ||
|
sauimone
|
r313 | /*! | ||
| Returns brush of the set. | ||||
| */ | ||||
|
sauimone
|
r473 | QBrush QBarSet::brush() const | ||
|
sauimone
|
r214 | { | ||
|
Michal Klocek
|
r938 | return d_ptr->m_brush; | ||
|
sauimone
|
r214 | } | ||
|
sauimone
|
r512 | /*! | ||
|
sauimone
|
r839 | Sets \a pen of the values that are drawn on top of this barset | ||
|
sauimone
|
r512 | */ | ||
|
sauimone
|
r820 | void QBarSet::setLabelPen(const QPen &pen) | ||
|
sauimone
|
r512 | { | ||
|
Michal Klocek
|
r938 | if(d_ptr->m_labelPen!=pen){ | ||
| d_ptr->m_labelPen = pen; | ||||
|
sauimone
|
r1008 | emit d_ptr->updatedBars(); | ||
|
Michal Klocek
|
r938 | } | ||
|
sauimone
|
r820 | } | ||
| /*! | ||||
| Returns pen of the values that are drawn on top of this barset | ||||
| */ | ||||
| QPen QBarSet::labelPen() const | ||||
| { | ||||
|
Michal Klocek
|
r938 | return d_ptr->m_labelPen; | ||
|
sauimone
|
r820 | } | ||
| /*! | ||||
|
sauimone
|
r839 | Sets \a brush of the values that are drawn on top of this barset | ||
|
sauimone
|
r820 | */ | ||
| void QBarSet::setLabelBrush(const QBrush &brush) | ||||
| { | ||||
|
Michal Klocek
|
r938 | if(d_ptr->m_labelBrush!=brush){ | ||
| d_ptr->m_labelBrush = brush; | ||||
|
sauimone
|
r1008 | emit d_ptr->updatedBars(); | ||
|
Michal Klocek
|
r938 | } | ||
|
sauimone
|
r820 | } | ||
| /*! | ||||
| Returns brush of the values that are drawn on top of this barset | ||||
| */ | ||||
| QBrush QBarSet::labelBrush() const | ||||
| { | ||||
|
Michal Klocek
|
r938 | return d_ptr->m_labelBrush; | ||
|
sauimone
|
r820 | } | ||
| /*! | ||||
|
sauimone
|
r839 | Sets the \a font for values that are drawn on top of this barset | ||
|
sauimone
|
r820 | */ | ||
| void QBarSet::setLabelFont(const QFont &font) | ||||
| { | ||||
|
Michal Klocek
|
r938 | if(d_ptr->m_labelFont!=font) { | ||
| d_ptr->m_labelFont = font; | ||||
|
sauimone
|
r1008 | emit d_ptr->updatedBars(); | ||
|
Michal Klocek
|
r938 | } | ||
|
sauimone
|
r512 | } | ||
| /*! | ||||
|
sauimone
|
r817 | Returns the pen for values that are drawn on top of this set | ||
|
sauimone
|
r512 | */ | ||
|
sauimone
|
r820 | QFont QBarSet::labelFont() const | ||
|
sauimone
|
r512 | { | ||
|
Michal Klocek
|
r938 | return d_ptr->m_labelFont; | ||
|
sauimone
|
r512 | } | ||
|
Michal Klocek
|
r938 | //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||
|
sauimone
|
r993 | QBarSetPrivate::QBarSetPrivate(const QString name, QBarSet *parent) : QObject(parent), | ||
|
Michal Klocek
|
r938 | q_ptr(parent), | ||
|
sauimone
|
r1246 | m_name(name) | ||
|
Michal Klocek
|
r938 | { | ||
| } | ||||
| QBarSetPrivate::~QBarSetPrivate() | ||||
| { | ||||
| } | ||||
|
sauimone
|
r1017 | |||
|
sauimone
|
r239 | #include "moc_qbarset.cpp" | ||
|
Michal Klocek
|
r938 | #include "moc_qbarset_p.cpp" | ||
|
Tero Ahola
|
r737 | |||
|
sauimone
|
r169 | QTCOMMERCIALCHART_END_NAMESPACE | ||