|
|
/****************************************************************************
|
|
|
**
|
|
|
** 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)
|
|
|
\brief signals that set has been clicked
|
|
|
Parameter \a category describes on which category was clicked
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\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->restructuredBars();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
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);
|
|
|
emit d_ptr->updatedBars();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Removes the value specified by \a index
|
|
|
\sa insert()
|
|
|
*/
|
|
|
void QBarSet::remove(const int index)
|
|
|
{
|
|
|
d_ptr->m_values.removeAt(index);
|
|
|
emit d_ptr->updatedBars();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
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->updatedBars();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
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->updatedBars();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
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->updatedBars();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
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->updatedBars();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
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->updatedBars();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
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->updatedBars();
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
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
|
|
|
|
