/**************************************************************************** ** ** 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$ ** ****************************************************************************/ #include "qbarset.h" #include "qbarset_p.h" QTCOMMERCIALCHART_BEGIN_NAMESPACE /*! \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. \mainclass \sa QBarSeries, QStackedBarSeries, QPercentBarSeries */ /*! \fn void QBarSet::clicked(QString category, Qt::MouseButtons button) \brief signals that set has been clicked Parameter \a category describes on which category was clicked Parameter \a button mouse button */ /*! \fn void QBarSet::selected() \brief signals that set has been selected */ /*! \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. 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. */ /*! Constructs QBarSet with a name of \a name and with parent of \a parent */ QBarSet::QBarSet(const QString name, QObject *parent) : QObject(parent) ,d_ptr(new QBarSetPrivate(name,this)) { } /*! Destroys the barset */ QBarSet::~QBarSet() { // NOTE: d_ptr destroyed by QObject } /*! Sets new \a name for set. */ void QBarSet::setName(const QString name) { d_ptr->m_name = name; } /*! Returns name of the set. */ QString QBarSet::name() const { return d_ptr->m_name; } /*! Appends new value \a value to the end of set. */ void QBarSet::append(const qreal value) { d_ptr->m_values.append(value); emit d_ptr->structureChanged(); } /*! Appends new value \a value to the end of set. */ QBarSet& QBarSet::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 \sa remove() */ void QBarSet::insert(const int index, const qreal value) { d_ptr->m_values.insert(index, value); } /*! Removes the value specified by \a index \sa insert() */ void QBarSet::remove(const int index) { d_ptr->m_values.removeAt(index); } /*! Sets a new value \a value to set, indexed by \a index */ void QBarSet::replace(const int index, const qreal value) { d_ptr->m_values.replace(index,value); emit d_ptr->valueChanged(); } /*! Returns value of set indexed by \a index */ qreal QBarSet::at(const int index) const { return d_ptr->m_values.at(index); } /*! Returns value of set indexed by \a index */ qreal QBarSet::operator [] (int index) const { return d_ptr->m_values.at(index); } /*! Returns count of values in set. */ int QBarSet::count() const { return d_ptr->m_values.count(); } /*! Returns sum of all values in barset. */ qreal QBarSet::sum() const { qreal total(0); for (int i=0; i < d_ptr->m_values.count(); i++) { total += d_ptr->m_values.at(i); } return total; } /*! Sets pen for set. Bars of this set are drawn using \a pen */ void QBarSet::setPen(const QPen &pen) { if(d_ptr->m_pen!=pen){ d_ptr->m_pen = pen; emit d_ptr->valueChanged(); } } /*! Returns pen of the set. */ QPen QBarSet::pen() const { return d_ptr->m_pen; } /*! Sets brush for the set. Bars of this set are drawn using \a brush */ void QBarSet::setBrush(const QBrush &brush) { if(d_ptr->m_brush!=brush){ d_ptr->m_brush = brush; emit d_ptr->valueChanged(); } } /*! Returns brush of the set. */ QBrush QBarSet::brush() const { return d_ptr->m_brush; } /*! Sets \a pen of the values that are drawn on top of this barset */ void QBarSet::setLabelPen(const QPen &pen) { if(d_ptr->m_labelPen!=pen){ d_ptr->m_labelPen = pen; emit d_ptr->valueChanged(); } } /*! Returns pen of the values that are drawn on top of this barset */ QPen QBarSet::labelPen() const { return d_ptr->m_labelPen; } /*! Sets \a brush of the values that are drawn on top of this barset */ void QBarSet::setLabelBrush(const QBrush &brush) { if(d_ptr->m_labelBrush!=brush){ d_ptr->m_labelBrush = brush; emit d_ptr->valueChanged(); } } /*! Returns brush of the values that are drawn on top of this barset */ QBrush QBarSet::labelBrush() const { return d_ptr->m_labelBrush; } /*! Sets the \a font for values that are drawn on top of this barset */ void QBarSet::setLabelFont(const QFont &font) { if(d_ptr->m_labelFont!=font) { d_ptr->m_labelFont = font; emit d_ptr->valueChanged(); } } /*! Returns the pen for values that are drawn on top of this set */ QFont QBarSet::labelFont() const { return d_ptr->m_labelFont; } /*! Sets visibility of bar labels. If \a visible is true, labels are drawn on top of barsets. */ void QBarSet::setLabelsVisible(bool visible) { if(d_ptr->m_labelsVisible!=visible) { d_ptr->m_labelsVisible = visible; emit d_ptr->labelsVisibleChanged(visible); } } /*! Returns the visibility of values */ bool QBarSet::labelsVisible() const { return d_ptr->m_labelsVisible; } //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// QBarSetPrivate::QBarSetPrivate(const QString name, QBarSet *parent) : QObject(parent), q_ptr(parent), m_name(name), m_labelsVisible(false) { } QBarSetPrivate::~QBarSetPrivate() { } #include "moc_qbarset.cpp" #include "moc_qbarset_p.cpp" QTCOMMERCIALCHART_END_NAMESPACE