|
|
/****************************************************************************
|
|
|
**
|
|
|
** 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 "qbarcategoryaxis.h"
|
|
|
#include "qbarcategoryaxis_p.h"
|
|
|
#include "chartbarcategoryaxisx_p.h"
|
|
|
#include "chartbarcategoryaxisy_p.h"
|
|
|
#include "domain_p.h"
|
|
|
#include "chartdataset_p.h"
|
|
|
#include <qmath.h>
|
|
|
|
|
|
QTCOMMERCIALCHART_BEGIN_NAMESPACE
|
|
|
/*!
|
|
|
\class QBarCategoryAxis
|
|
|
\brief The QBarCategoryAxis class is used for manipulating chart's axis.
|
|
|
\mainclass
|
|
|
|
|
|
BarCategoryAxis can be setup to show axis line with tick marks, grid lines and shades.
|
|
|
Categories are drawn between ticks. Note that you can use this also with lineseries too.
|
|
|
See the \l {Line and BarChart Example} {Line and BarChart Example} to learn how to do that.
|
|
|
|
|
|
Example code on how to use QBarCategoryAxis.
|
|
|
\code
|
|
|
QChartView *chartView = new QChartView;
|
|
|
QBarSeries *series = new QBarSeries;
|
|
|
// ...
|
|
|
chartView->chart()->addSeries(series);
|
|
|
chartView->chart()->createDefaultAxes();
|
|
|
|
|
|
QBarCategoryAxis *axisX = new QBarCategoryAxis;
|
|
|
QStringList categories;
|
|
|
categories << "Jan" << "Feb" << "Mar" << "Apr" << "May" << "Jun";
|
|
|
axisX->append(categories);
|
|
|
axisX->setRange("Feb", "May");
|
|
|
chartView->chart()->setAxisX(axisX, series);
|
|
|
\endcode
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\qmlclass BarCategoryAxis QBarCategoryAxis
|
|
|
\inherits AbstractAxis
|
|
|
\brief The Axis element is used for manipulating chart's axes.
|
|
|
|
|
|
Axis can be setup to show axis line with tick marks, grid lines and shades.
|
|
|
Categories are drawn between ticks. Note that you can use this also with lineseries too.
|
|
|
|
|
|
To access BarCategoryAxis you can use ChartView API. For example:
|
|
|
\code
|
|
|
ChartView {
|
|
|
BarCategoryAxis {
|
|
|
id: categoryAxis
|
|
|
categories: ["Jan", "Feb", "Mar", "Apr", "May", "Jun" ]
|
|
|
}
|
|
|
// Add a few series...
|
|
|
}
|
|
|
\endcode
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QBarCategoryAxis::categories
|
|
|
Defines the categories of axis
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty QStringList BarCategoryAxis::categories
|
|
|
Defines the categories of axis
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QBarCategoryAxis::min
|
|
|
Defines the minimum value on the axis.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty QString BarCategoryAxis::min
|
|
|
Defines the minimum value on the axis.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QBarCategoryAxis::max
|
|
|
Defines the maximum value on the axis.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty QString BarCategoryAxis::max
|
|
|
Defines the maximum value on the axis.
|
|
|
*/
|
|
|
|
|
|
|
|
|
/*!
|
|
|
\fn void QBarCategoryAxis::categoriesChanged()
|
|
|
Axis emits signal when the categories of the axis has changed.
|
|
|
*/
|
|
|
/*!
|
|
|
\fn void QBarCategoryAxis::minChanged(const QString &min)
|
|
|
Axis emits signal when \a min of axis has changed.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlsignal BarCategoryAxis::onMinChanged(const QString &min)
|
|
|
Axis emits signal when \a min of axis has changed.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QBarCategoryAxis::maxChanged(const QString &max)
|
|
|
Axis emits signal when \a max of axis has changed.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlsignal BarCategoryAxis::onMaxChanged(const QString &max)
|
|
|
Axis emits signal when \a max of axis has changed.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QBarCategoryAxis::rangeChanged(const QString &min, const QString &max)
|
|
|
Axis emits signal when \a min or \a max of axis has changed.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
Constructs an axis object which is a child of \a parent.
|
|
|
*/
|
|
|
QBarCategoryAxis::QBarCategoryAxis(QObject *parent):
|
|
|
QAbstractAxis(*new QBarCategoryAxisPrivate(this), parent)
|
|
|
{
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Destroys the object
|
|
|
*/
|
|
|
QBarCategoryAxis::~QBarCategoryAxis()
|
|
|
{
|
|
|
Q_D(QBarCategoryAxis);
|
|
|
if (d->m_dataset)
|
|
|
d->m_dataset->removeAxis(this);
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
\internal
|
|
|
*/
|
|
|
QBarCategoryAxis::QBarCategoryAxis(QBarCategoryAxisPrivate &d, QObject *parent)
|
|
|
: QAbstractAxis(d, parent)
|
|
|
{
|
|
|
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Appends \a categories to axis. A maximum of the axis will be changed to last category in \a categories.
|
|
|
If there were no categories previously defined, minimum of axis will be also changed to first category in \a categories.
|
|
|
A category has to be valid QStrings and can not be duplicated. Duplicated categories will not be appended.
|
|
|
*/
|
|
|
void QBarCategoryAxis::append(const QStringList &categories)
|
|
|
{
|
|
|
if (categories.isEmpty())
|
|
|
return;
|
|
|
|
|
|
Q_D(QBarCategoryAxis);
|
|
|
|
|
|
int count = d->m_categories.count();
|
|
|
|
|
|
foreach(QString category, categories) {
|
|
|
if (!d->m_categories.contains(category) && !category.isNull()) {
|
|
|
d->m_categories.append(category);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
if (d->m_categories.count() == count)
|
|
|
return;
|
|
|
|
|
|
if (count == 0)
|
|
|
setRange(d->m_categories.first(), d->m_categories.last());
|
|
|
else
|
|
|
setRange(d->m_minCategory, d->m_categories.last());
|
|
|
|
|
|
emit categoriesChanged();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Appends \a category to axis. A maximum of the axis will be changed to last \a category.
|
|
|
If there were no categories previously defined, minimum of axis will be also changed to \a category.
|
|
|
A \a category has to be valid QStrings and can not be duplicated. Duplicated categories will not be appended.
|
|
|
*/
|
|
|
void QBarCategoryAxis::append(const QString &category)
|
|
|
{
|
|
|
Q_D(QBarCategoryAxis);
|
|
|
|
|
|
int count = d->m_categories.count();
|
|
|
|
|
|
if (!d->m_categories.contains(category) && !category.isNull())
|
|
|
d->m_categories.append(category);
|
|
|
|
|
|
if (d->m_categories.count() == count)
|
|
|
return;
|
|
|
|
|
|
if (count == 0)
|
|
|
setRange(d->m_categories.last(), d->m_categories.last());
|
|
|
else
|
|
|
setRange(d->m_minCategory, d->m_categories.last());
|
|
|
|
|
|
emit categoriesChanged();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Removes \a category from axis. Removing category which is currently maximum or minimum
|
|
|
will affect the axis range.
|
|
|
*/
|
|
|
void QBarCategoryAxis::remove(const QString &category)
|
|
|
{
|
|
|
Q_D(QBarCategoryAxis);
|
|
|
|
|
|
if (d->m_categories.contains(category)) {
|
|
|
d->m_categories.removeAt(d->m_categories.indexOf(category));
|
|
|
if (!d->m_categories.isEmpty()) {
|
|
|
if (d->m_minCategory == category) {
|
|
|
setRange(d->m_categories.first(), d->m_maxCategory);
|
|
|
} else if (d->m_maxCategory == category) {
|
|
|
setRange(d->m_minCategory, d->m_categories.last());
|
|
|
} else {
|
|
|
d->updateCategoryDomain();
|
|
|
d->emitUpdated();
|
|
|
}
|
|
|
} else {
|
|
|
setRange(QString::null, QString::null);
|
|
|
}
|
|
|
emit categoriesChanged();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Inserts \a category to axis at \a index. A \a category has to be valid QStrings and can not be duplicated.
|
|
|
If \a category is prepended or appended to categories, minimum and maximum of axis is updated accordingly.
|
|
|
*/
|
|
|
void QBarCategoryAxis::insert(int index, const QString &category)
|
|
|
{
|
|
|
Q_D(QBarCategoryAxis);
|
|
|
|
|
|
int count = d->m_categories.count();
|
|
|
|
|
|
if (!d->m_categories.contains(category) && !category.isNull())
|
|
|
d->m_categories.insert(index, category);
|
|
|
|
|
|
if (d->m_categories.count() == count)
|
|
|
return;
|
|
|
|
|
|
if (count == 0) {
|
|
|
setRange(d->m_categories.first(), d->m_categories.first());
|
|
|
} else if (index == 0) {
|
|
|
setRange(d->m_categories.first(), d->m_maxCategory);
|
|
|
} else if (index == count) {
|
|
|
setRange(d->m_minCategory, d->m_categories.last());
|
|
|
} else {
|
|
|
d->updateCategoryDomain();
|
|
|
d->emitUpdated();
|
|
|
}
|
|
|
|
|
|
emit categoriesChanged();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Replaces \a oldCategory with \a newCategory. If \a oldCategory does not exits on the axis nothing is done.
|
|
|
A \a newVategory has to be valid QStrings and can not be duplicated. In case of replacing minimum or maximum category,
|
|
|
minimum and maximum of axis is updated accordingly.
|
|
|
*/
|
|
|
void QBarCategoryAxis::replace(const QString &oldCategory, const QString &newCategory)
|
|
|
{
|
|
|
Q_D(QBarCategoryAxis);
|
|
|
|
|
|
int pos = d->m_categories.indexOf(oldCategory);
|
|
|
|
|
|
if (pos != -1 && !d->m_categories.contains(newCategory) && !newCategory.isNull()) {
|
|
|
d->m_categories.replace(pos, newCategory);
|
|
|
if (d->m_minCategory == oldCategory) {
|
|
|
setRange(newCategory, d->m_maxCategory);
|
|
|
} else if (d->m_maxCategory == oldCategory) {
|
|
|
setRange(d->m_minCategory, newCategory);
|
|
|
} else {
|
|
|
d->emitUpdated();
|
|
|
}
|
|
|
emit categoriesChanged();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Removes all categories. Sets the maximum and minimum of the axis's range to QString::null.
|
|
|
*/
|
|
|
void QBarCategoryAxis::clear()
|
|
|
{
|
|
|
Q_D(QBarCategoryAxis);
|
|
|
d->m_categories.clear();
|
|
|
setRange(QString::null, QString::null);
|
|
|
emit categoriesChanged();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Set \a categories and discards the old ones, range of axis is adjusted to match first and last category in \a categories.
|
|
|
A category has to be valid QStrings and can not be duplicated.
|
|
|
*/
|
|
|
void QBarCategoryAxis::setCategories(const QStringList &categories)
|
|
|
{
|
|
|
Q_D(QBarCategoryAxis);
|
|
|
d->m_categories.clear();
|
|
|
d->m_minCategory = QString::null;
|
|
|
d->m_maxCategory = QString::null;
|
|
|
d->m_min = 0;
|
|
|
d->m_max = 0;
|
|
|
d->m_count = 0;
|
|
|
append(categories);
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns categories
|
|
|
*/
|
|
|
QStringList QBarCategoryAxis::categories()
|
|
|
{
|
|
|
Q_D(QBarCategoryAxis);
|
|
|
return d->m_categories;
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns number of categories.
|
|
|
*/
|
|
|
int QBarCategoryAxis::count() const
|
|
|
{
|
|
|
Q_D(const QBarCategoryAxis);
|
|
|
return d->m_categories.count();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns category at \a index. Index must be valid.
|
|
|
*/
|
|
|
QString QBarCategoryAxis::at(int index) const
|
|
|
{
|
|
|
Q_D(const QBarCategoryAxis);
|
|
|
return d->m_categories.at(index);
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Sets minimum category to \a min.
|
|
|
*/
|
|
|
void QBarCategoryAxis::setMin(const QString &min)
|
|
|
{
|
|
|
Q_D(QBarCategoryAxis);
|
|
|
setRange(min, d->m_maxCategory);
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns minimum category.
|
|
|
*/
|
|
|
QString QBarCategoryAxis::min() const
|
|
|
{
|
|
|
Q_D(const QBarCategoryAxis);
|
|
|
return d->m_minCategory;
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Sets maximum category to \a max.
|
|
|
*/
|
|
|
void QBarCategoryAxis::setMax(const QString &max)
|
|
|
{
|
|
|
Q_D(QBarCategoryAxis);
|
|
|
setRange(d->m_minCategory, max);
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns maximum category
|
|
|
*/
|
|
|
QString QBarCategoryAxis::max() const
|
|
|
{
|
|
|
Q_D(const QBarCategoryAxis);
|
|
|
return d->m_maxCategory;
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Sets range from \a minCategory to \a maxCategory
|
|
|
*/
|
|
|
void QBarCategoryAxis::setRange(const QString &minCategory, const QString &maxCategory)
|
|
|
{
|
|
|
Q_D(QBarCategoryAxis);
|
|
|
|
|
|
bool changed = false;
|
|
|
|
|
|
//special case in case or clearing all categories
|
|
|
if (minCategory.isNull() && maxCategory.isNull()) {
|
|
|
d->m_minCategory = minCategory;
|
|
|
d->m_maxCategory = maxCategory;
|
|
|
d->m_min = 0;
|
|
|
d->m_max = 0;
|
|
|
emit minChanged(minCategory);
|
|
|
emit maxChanged(maxCategory);
|
|
|
d->m_count = 0;
|
|
|
emit rangeChanged(d->m_minCategory, d->m_maxCategory);
|
|
|
d->emitUpdated();
|
|
|
}
|
|
|
|
|
|
if (d->m_categories.indexOf(maxCategory) < d->m_categories.indexOf(minCategory))
|
|
|
return;
|
|
|
|
|
|
if (!minCategory.isEmpty() && d->m_minCategory != minCategory && d->m_categories.contains(minCategory)) {
|
|
|
d->m_minCategory = minCategory;
|
|
|
d->m_min = d->m_categories.indexOf(d->m_minCategory) - 0.5;
|
|
|
changed = true;
|
|
|
emit minChanged(minCategory);
|
|
|
}
|
|
|
|
|
|
if (!maxCategory.isEmpty() && d->m_maxCategory != maxCategory && d->m_categories.contains(maxCategory)) {
|
|
|
d->m_maxCategory = maxCategory;
|
|
|
d->m_max = d->m_categories.indexOf(d->m_maxCategory) + 0.5;
|
|
|
changed = true;
|
|
|
emit maxChanged(maxCategory);
|
|
|
}
|
|
|
|
|
|
if (changed) {
|
|
|
d->m_count = d->m_max - d->m_min;
|
|
|
emit rangeChanged(d->m_minCategory, d->m_maxCategory);
|
|
|
d->emitUpdated();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns the type of the axis
|
|
|
*/
|
|
|
QAbstractAxis::AxisType QBarCategoryAxis::type() const
|
|
|
{
|
|
|
return AxisTypeBarCategory;
|
|
|
}
|
|
|
|
|
|
//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
QBarCategoryAxisPrivate::QBarCategoryAxisPrivate(QBarCategoryAxis *q)
|
|
|
: QAbstractAxisPrivate(q),
|
|
|
m_min(0.0),
|
|
|
m_max(0.0),
|
|
|
m_count(0)
|
|
|
{
|
|
|
|
|
|
}
|
|
|
|
|
|
QBarCategoryAxisPrivate::~QBarCategoryAxisPrivate()
|
|
|
{
|
|
|
|
|
|
}
|
|
|
|
|
|
void QBarCategoryAxisPrivate::setMin(const QVariant &min)
|
|
|
{
|
|
|
setRange(min, m_maxCategory);
|
|
|
}
|
|
|
|
|
|
void QBarCategoryAxisPrivate::setMax(const QVariant &max)
|
|
|
{
|
|
|
setRange(m_minCategory, max);
|
|
|
}
|
|
|
|
|
|
void QBarCategoryAxisPrivate::setRange(const QVariant &min, const QVariant &max)
|
|
|
{
|
|
|
Q_Q(QBarCategoryAxis);
|
|
|
QString value1 = min.toString();
|
|
|
QString value2 = max.toString();
|
|
|
q->setRange(value1, value2);
|
|
|
}
|
|
|
|
|
|
void QBarCategoryAxisPrivate::handleDomainUpdated()
|
|
|
{
|
|
|
Q_Q(QBarCategoryAxis);
|
|
|
Domain *domain = qobject_cast<Domain *>(sender());
|
|
|
|
|
|
if (m_orientation == Qt::Horizontal) {
|
|
|
m_min = domain->minX();
|
|
|
m_max = domain->maxX();
|
|
|
} else if (m_orientation == Qt::Vertical) {
|
|
|
m_min = domain->minY();
|
|
|
m_max = domain->maxY();
|
|
|
}
|
|
|
|
|
|
bool changed = false;
|
|
|
|
|
|
int min = m_min + 0.5;
|
|
|
if (min >= 0 && min < m_categories.count()) {
|
|
|
QString minCategory = m_categories.at(min);
|
|
|
if (m_minCategory != minCategory && !minCategory.isEmpty()) {
|
|
|
m_minCategory = minCategory;
|
|
|
changed = true;
|
|
|
emit q->minChanged(minCategory);
|
|
|
}
|
|
|
}
|
|
|
int max = m_max - 0.5;
|
|
|
if (max >= 0 && max < m_categories.count()) {
|
|
|
QString maxCategory = m_categories.at(max);
|
|
|
if (m_maxCategory != maxCategory && !maxCategory.isEmpty()) {
|
|
|
m_maxCategory = maxCategory;
|
|
|
emit q->maxChanged(maxCategory);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
if (changed)
|
|
|
emit q->rangeChanged(m_minCategory, m_maxCategory);
|
|
|
}
|
|
|
|
|
|
ChartAxis *QBarCategoryAxisPrivate::createGraphics(ChartPresenter *presenter)
|
|
|
{
|
|
|
Q_Q(QBarCategoryAxis);
|
|
|
if (m_orientation == Qt::Vertical)
|
|
|
return new ChartBarCategoryAxisY(q, presenter);
|
|
|
return new ChartBarCategoryAxisX(q, presenter);
|
|
|
}
|
|
|
|
|
|
void QBarCategoryAxisPrivate::updateCategoryDomain()
|
|
|
{
|
|
|
m_min = m_categories.indexOf(m_minCategory) - 0.5;
|
|
|
m_max = m_categories.indexOf(m_maxCategory) + 0.5;
|
|
|
m_count = m_max - m_min;
|
|
|
}
|
|
|
|
|
|
|
|
|
void QBarCategoryAxisPrivate::intializeDomain(Domain *domain)
|
|
|
{
|
|
|
|
|
|
Q_Q(QBarCategoryAxis);
|
|
|
if (m_max == m_min) {
|
|
|
int min;
|
|
|
int max;
|
|
|
if (m_orientation == Qt::Vertical) {
|
|
|
min = domain->minY() + 0.5;
|
|
|
max = domain->maxY() - 0.5;
|
|
|
} else {
|
|
|
min = domain->minX() + 0.5;
|
|
|
max = domain->maxX() - 0.5;
|
|
|
}
|
|
|
|
|
|
if (min > 0 && min < m_categories.count() && max > 0 && max < m_categories.count())
|
|
|
q->setRange(m_categories.at(min), m_categories.at(max));
|
|
|
} else {
|
|
|
if (m_orientation == Qt::Vertical)
|
|
|
domain->setRangeY(m_min, m_max);
|
|
|
else
|
|
|
domain->setRangeX(m_min, m_max);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
#include "moc_qbarcategoryaxis.cpp"
|
|
|
#include "moc_qbarcategoryaxis_p.cpp"
|
|
|
|
|
|
QTCOMMERCIALCHART_END_NAMESPACE
|
|
|
|
