|
|
/****************************************************************************
|
|
|
**
|
|
|
** 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 "qbarseries.h"
|
|
|
#include "qbarseries_p.h"
|
|
|
#include "qbarset.h"
|
|
|
#include "qbarset_p.h"
|
|
|
#include "barchartmodel_p.h"
|
|
|
#include "domain_p.h"
|
|
|
#include "legendmarker_p.h"
|
|
|
#include "chartdataset_p.h"
|
|
|
#include "charttheme_p.h"
|
|
|
#include "chartanimator_p.h"
|
|
|
|
|
|
#include <QAbstractItemModel>
|
|
|
#include <QModelIndex>
|
|
|
|
|
|
QTCOMMERCIALCHART_BEGIN_NAMESPACE
|
|
|
|
|
|
/*!
|
|
|
\class QBarSeries
|
|
|
\brief part of QtCommercial chart API.
|
|
|
\mainclass
|
|
|
|
|
|
QBarSeries represents a series of data shown as bars. One QBarSeries can contain multiple
|
|
|
QBarSet data sets. QBarSeries groups the data from sets to categories, which are defined
|
|
|
by QStringList.
|
|
|
|
|
|
See the \l {BarChart Example} {bar chart example} to learn how to create a simple bar chart.
|
|
|
\image examples_barchart.png
|
|
|
|
|
|
\sa QBarSet, QStackedBarSeries, QPercentBarSeries
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QBarSeries::clicked(QBarSet *barset, QString category, Qt::MouseButtons button)
|
|
|
|
|
|
The signal is emitted if the user clicks with a mouse \a button on top of QBarSet \a barset of category \a category
|
|
|
contained by the series.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QBarSeries::selected()
|
|
|
|
|
|
The signal is emitted if the user selects/deselects the series. The logic for storing selections should be
|
|
|
implemented by the user of QBarSeries API.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QBarSeries::hovered(QBarSet* barset, bool status)
|
|
|
|
|
|
The signal is emitted if mouse is hovered on top of series.
|
|
|
Parameter \a barset is the pointer of barset, where hover happened.
|
|
|
Parameter \a status is true, if mouse entered on top of series, false if mouse left from top of series.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
Constructs empty QBarSeries. Parameter \a categories defines the categories for chart.
|
|
|
QBarSeries is QObject which is a child of a \a parent.
|
|
|
*/
|
|
|
QBarSeries::QBarSeries(QBarCategories categories, QObject *parent) :
|
|
|
QAbstractSeries(*new QBarSeriesPrivate(categories, this),parent)
|
|
|
{
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Destructs barseries and owned barsets.
|
|
|
*/
|
|
|
QBarSeries::~QBarSeries()
|
|
|
{
|
|
|
// NOTE: d_ptr destroyed by QObject
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
\internal
|
|
|
*/
|
|
|
QBarSeries::QBarSeries(QBarSeriesPrivate &d, QObject *parent) :
|
|
|
QAbstractSeries(d,parent)
|
|
|
{
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns the type of series. Derived classes override this.
|
|
|
*/
|
|
|
QAbstractSeries::QSeriesType QBarSeries::type() const
|
|
|
{
|
|
|
return QAbstractSeries::SeriesTypeBar;
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Adds a set of bars to series. Takes ownership of \a set.
|
|
|
Connects the clicked(QString, Qt::MouseButtons) signal
|
|
|
of \a set to this series
|
|
|
*/
|
|
|
void QBarSeries::appendBarSet(QBarSet *set)
|
|
|
{
|
|
|
Q_D(QBarSeries);
|
|
|
d->m_internalModel->appendBarSet(set);
|
|
|
QObject::connect(set->d_ptr.data(), SIGNAL(valueChanged()), d, SLOT(barsetChanged()));
|
|
|
emit d->restructuredBars();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Removes a set of bars from series. Releases ownership of \a set. Doesn't delete \a set.
|
|
|
Disconnects the clicked(QString, Qt::MouseButtons) signal
|
|
|
of \a set from this series
|
|
|
*/
|
|
|
void QBarSeries::removeBarSet(QBarSet *set)
|
|
|
{
|
|
|
Q_D(QBarSeries);
|
|
|
d->m_internalModel->removeBarSet(set);
|
|
|
emit d->restructuredBars();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Adds a list of barsets to series. Takes ownership of \a sets.
|
|
|
Connects the clicked(QString, Qt::MouseButtons) signals
|
|
|
of \a sets to this series
|
|
|
*/
|
|
|
void QBarSeries::appendBarSets(QList<QBarSet* > sets)
|
|
|
{
|
|
|
Q_D(QBarSeries);
|
|
|
foreach (QBarSet* barset, sets) {
|
|
|
d->m_internalModel->appendBarSet(barset);
|
|
|
QObject::connect(barset, SIGNAL(valueChanged()), this, SLOT(barsetChanged()));
|
|
|
}
|
|
|
emit d->restructuredBars();
|
|
|
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Removes a list of barsets from series. Releases ownership of \a sets. Doesn't delete \a sets.
|
|
|
Disconnects the clicked(QString, Qt::MouseButtons) signal
|
|
|
of \a sets from this series
|
|
|
*/
|
|
|
void QBarSeries::removeBarSets(QList<QBarSet* > sets)
|
|
|
{
|
|
|
Q_D(QBarSeries);
|
|
|
|
|
|
foreach (QBarSet* barset, sets) {
|
|
|
d->m_internalModel->removeBarSet(barset);
|
|
|
}
|
|
|
emit d->restructuredBars();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Inserts new \a set on the \a i position.
|
|
|
The barset that is currently at this postion is moved to postion i + 1
|
|
|
*/
|
|
|
void QBarSeries::insertBarSet(int i, QBarSet *set)
|
|
|
{
|
|
|
Q_D(QBarSeries);
|
|
|
d->m_internalModel->insertBarSet(i, set);
|
|
|
emit d->barsetChanged();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns number of sets in series.
|
|
|
*/
|
|
|
int QBarSeries::barsetCount() const
|
|
|
{
|
|
|
Q_D(const QBarSeries);
|
|
|
return d->m_internalModel->barsetCount();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns number of categories in series
|
|
|
*/
|
|
|
int QBarSeries::categoryCount() const
|
|
|
{
|
|
|
Q_D(const QBarSeries);
|
|
|
return d->m_internalModel->categoryCount();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns a list of sets in series. Keeps ownership of sets.
|
|
|
*/
|
|
|
QList<QBarSet*> QBarSeries::barSets() const
|
|
|
{
|
|
|
Q_D(const QBarSeries);
|
|
|
return d->m_internalModel->barSets();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
\fn bool QBarSeries::setModel(QAbstractItemModel *model)
|
|
|
Sets the \a model to be used as a data source
|
|
|
*/
|
|
|
bool QBarSeries::setModel(QAbstractItemModel *model)
|
|
|
{
|
|
|
Q_D(QBarSeries);
|
|
|
return d->setModel(model);
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
\fn bool QBarSeries::setModelMapping(int categories, int bottomBoundry, int topBoundry, Qt::Orientation orientation)
|
|
|
Sets column/row specified by \a categories to be used as a list of bar series categories.
|
|
|
Parameter \a bottomBoundry indicates the column/row where the first bar set is located in the model.
|
|
|
Parameter \a topBoundry indicates the column/row where the last bar set is located in the model.
|
|
|
All the columns/rows inbetween those two values are also used as data for bar sets.
|
|
|
The \a orientation parameter specifies whether the data is in columns or in rows.
|
|
|
*/
|
|
|
void QBarSeries::setModelMapping(int categories, int bottomBoundary, int topBoundary, Qt::Orientation orientation)
|
|
|
{
|
|
|
Q_D(QBarSeries);
|
|
|
d->setModelMapping(categories,bottomBoundary,topBoundary,orientation);
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns the bar categories of the series.
|
|
|
*/
|
|
|
QBarCategories QBarSeries::categories() const
|
|
|
{
|
|
|
Q_D(const QBarSeries);
|
|
|
|
|
|
QBarCategories categories;
|
|
|
int count = d->m_internalModel->categoryCount();
|
|
|
for (int i=1; i <= count; i++) {
|
|
|
categories.insert(i, d->m_internalModel->categoryName(i - 1));
|
|
|
}
|
|
|
return categories;
|
|
|
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Sets the visibility of labels in series to \a visible
|
|
|
*/
|
|
|
void QBarSeries::setLabelsVisible(bool visible)
|
|
|
{
|
|
|
foreach (QBarSet* s, barSets()) {
|
|
|
s->setLabelsVisible(visible);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
QBarSeriesPrivate::QBarSeriesPrivate(QBarCategories categories, QBarSeries *q) :
|
|
|
QAbstractSeriesPrivate(q),
|
|
|
m_internalModel(new BarChartModel(categories,this)),
|
|
|
m_model(0),
|
|
|
m_mapCategories(-1),
|
|
|
m_mapBarBottom(-1),
|
|
|
m_mapBarTop(-1),
|
|
|
m_mapOrientation(Qt::Vertical)
|
|
|
{
|
|
|
}
|
|
|
|
|
|
QBarSet* QBarSeriesPrivate::barsetAt(int index)
|
|
|
{
|
|
|
return m_internalModel->barsetAt(index);
|
|
|
}
|
|
|
|
|
|
QString QBarSeriesPrivate::categoryName(int category)
|
|
|
{
|
|
|
return m_internalModel->categoryName(category);
|
|
|
}
|
|
|
|
|
|
qreal QBarSeriesPrivate::min()
|
|
|
{
|
|
|
return m_internalModel->min();
|
|
|
}
|
|
|
|
|
|
qreal QBarSeriesPrivate::max()
|
|
|
{
|
|
|
return m_internalModel->max();
|
|
|
}
|
|
|
|
|
|
qreal QBarSeriesPrivate::valueAt(int set, int category)
|
|
|
{
|
|
|
return m_internalModel->valueAt(set, category);
|
|
|
}
|
|
|
|
|
|
qreal QBarSeriesPrivate::percentageAt(int set, int category)
|
|
|
{
|
|
|
return m_internalModel->percentageAt(set, category);
|
|
|
}
|
|
|
|
|
|
qreal QBarSeriesPrivate::categorySum(int category)
|
|
|
{
|
|
|
return m_internalModel->categorySum(category);
|
|
|
}
|
|
|
|
|
|
qreal QBarSeriesPrivate::absoluteCategorySum(int category)
|
|
|
{
|
|
|
return m_internalModel->absoluteCategorySum(category);
|
|
|
}
|
|
|
|
|
|
qreal QBarSeriesPrivate::maxCategorySum()
|
|
|
{
|
|
|
return m_internalModel->maxCategorySum();
|
|
|
}
|
|
|
|
|
|
BarChartModel& QBarSeriesPrivate::modelInternal()
|
|
|
{
|
|
|
return *m_internalModel;
|
|
|
}
|
|
|
|
|
|
bool QBarSeriesPrivate::setModel(QAbstractItemModel *model)
|
|
|
{
|
|
|
// disconnect signals from old model
|
|
|
if(m_model)
|
|
|
{
|
|
|
disconnect(m_model, 0, this, 0);
|
|
|
m_mapCategories = -1;
|
|
|
m_mapBarBottom = -1;
|
|
|
m_mapBarTop = -1;
|
|
|
m_mapOrientation = Qt::Vertical;
|
|
|
}
|
|
|
|
|
|
// set new model
|
|
|
if(model)
|
|
|
{
|
|
|
m_model = model;
|
|
|
return true;
|
|
|
}
|
|
|
else
|
|
|
{
|
|
|
m_model = 0;
|
|
|
return false;
|
|
|
}
|
|
|
}
|
|
|
|
|
|
void QBarSeriesPrivate::setModelMapping(int categories, int bottomBoundry, int topBoundry, Qt::Orientation orientation)
|
|
|
{
|
|
|
Q_Q(QBarSeries);
|
|
|
|
|
|
if (m_model == 0)
|
|
|
return;
|
|
|
|
|
|
m_mapCategories = categories;
|
|
|
m_mapBarBottom = bottomBoundry;
|
|
|
m_mapBarTop = topBoundry;
|
|
|
m_mapOrientation = orientation;
|
|
|
|
|
|
// connect the signals
|
|
|
connect(m_model,SIGNAL(dataChanged(QModelIndex,QModelIndex)),
|
|
|
this, SLOT(modelUpdated(QModelIndex,QModelIndex)));
|
|
|
|
|
|
// create the initial bars
|
|
|
delete m_internalModel;
|
|
|
if (m_mapOrientation == Qt::Vertical) {
|
|
|
QStringList categories;
|
|
|
for (int k = 0; k < m_model->rowCount(); k++)
|
|
|
categories << m_model->data(m_model->index(k, m_mapCategories), Qt::DisplayRole).toString();
|
|
|
m_internalModel = new BarChartModel(categories, this);
|
|
|
|
|
|
for (int i = m_mapBarBottom; i <= m_mapBarTop; i++) {
|
|
|
QBarSet* barSet = new QBarSet(QString("Column: %1").arg(i + 1));
|
|
|
for(int m = 0; m < m_model->rowCount(); m++)
|
|
|
*barSet << m_model->data(m_model->index(m, i), Qt::DisplayRole).toDouble();
|
|
|
q->appendBarSet(barSet);
|
|
|
}
|
|
|
} else {
|
|
|
QStringList categories;
|
|
|
for (int k = 0; k < m_model->columnCount(); k++)
|
|
|
categories << m_model->data(m_model->index(m_mapCategories, k), Qt::DisplayRole).toString();
|
|
|
m_internalModel = new BarChartModel(categories, this);
|
|
|
|
|
|
for (int i = m_mapBarBottom; i <= m_mapBarTop; i++) {
|
|
|
QBarSet* barSet = new QBarSet(QString("Row: %1").arg(i + 1));
|
|
|
for(int m = 0; m < m_model->columnCount(); m++)
|
|
|
*barSet << m_model->data(m_model->index(i, m), Qt::DisplayRole).toDouble();
|
|
|
q->appendBarSet(barSet);
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
|
|
|
void QBarSeriesPrivate::modelUpdated(QModelIndex topLeft, QModelIndex bottomRight)
|
|
|
{
|
|
|
Q_UNUSED(bottomRight)
|
|
|
|
|
|
if (m_mapOrientation == Qt::Vertical)
|
|
|
{
|
|
|
// model update is relevant to BarSeries if the change was made to the part of the model that was mapped to BarSeries
|
|
|
if (topLeft.column() >= m_mapBarBottom && topLeft.column() <= m_mapBarTop)
|
|
|
barsetAt(topLeft.column() - m_mapBarBottom)->replace(topLeft.row(), m_model->data(topLeft, Qt::DisplayRole).toDouble());
|
|
|
}
|
|
|
else
|
|
|
{
|
|
|
// model update is relevant to BarSeries if the change was made to the part of the model that was mapped to BarSeries
|
|
|
if (topLeft.row() >= m_mapBarBottom && topLeft.row() <= m_mapBarTop)
|
|
|
barsetAt(topLeft.row() - m_mapBarBottom)->replace(topLeft.column(), m_model->data(topLeft, Qt::DisplayRole).toDouble());
|
|
|
}
|
|
|
}
|
|
|
|
|
|
void QBarSeriesPrivate::barsetChanged()
|
|
|
{
|
|
|
emit updatedBars();
|
|
|
}
|
|
|
|
|
|
void QBarSeriesPrivate::scaleDomain(Domain& domain)
|
|
|
{
|
|
|
qreal minX(domain.minX());
|
|
|
qreal minY(domain.minY());
|
|
|
qreal maxX(domain.maxX());
|
|
|
qreal maxY(domain.maxY());
|
|
|
int tickXCount(domain.tickXCount());
|
|
|
int tickYCount(domain.tickYCount());
|
|
|
|
|
|
qreal x = m_internalModel->categoryCount();
|
|
|
qreal y = max();
|
|
|
minX = qMin(minX, x);
|
|
|
minY = qMin(minY, y);
|
|
|
maxX = qMax(maxX, x);
|
|
|
maxY = qMax(maxY, y);
|
|
|
tickXCount = x+1;
|
|
|
|
|
|
domain.setRangeX(minX,maxX,tickXCount);
|
|
|
domain.setRangeY(minY,maxY,tickYCount);
|
|
|
}
|
|
|
|
|
|
Chart* QBarSeriesPrivate::createGraphics(ChartPresenter* presenter)
|
|
|
{
|
|
|
Q_Q(QBarSeries);
|
|
|
|
|
|
BarChartItem* bar = new BarChartItem(q,presenter);
|
|
|
if(presenter->animationOptions().testFlag(QChart::SeriesAnimations)) {
|
|
|
presenter->animator()->addAnimation(bar);
|
|
|
}
|
|
|
presenter->chartTheme()->decorate(q, presenter->dataSet()->seriesIndex(q));
|
|
|
return bar;
|
|
|
|
|
|
}
|
|
|
|
|
|
QList<LegendMarker*> QBarSeriesPrivate::createLegendMarker(QLegend* legend)
|
|
|
{
|
|
|
Q_Q(QBarSeries);
|
|
|
QList<LegendMarker*> markers;
|
|
|
foreach(QBarSet* set, q->barSets()) {
|
|
|
BarLegendMarker* marker = new BarLegendMarker(q,set,legend);
|
|
|
markers << marker;
|
|
|
}
|
|
|
|
|
|
return markers;
|
|
|
}
|
|
|
|
|
|
#include "moc_qbarseries.cpp"
|
|
|
#include "moc_qbarseries_p.cpp"
|
|
|
|
|
|
QTCOMMERCIALCHART_END_NAMESPACE
|
|
|
|
