##// END OF EJS Templates
fix painting coordinates and added LGPL
fix painting coordinates and added LGPL

File last commit:

r0:5db0360e1259 default
r7:a8e6b5a8e8d0 tip default
Show More
qbarcategoryaxis.cpp
628 lines | 17.0 KiB | text/x-c | CppLexer
/****************************************************************************
**
** Copyright (C) 2016 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the Qt Charts module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:GPL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3 or (at your option) any later version
** approved by the KDE Free Qt Foundation. The licenses are as published by
** the Free Software Foundation and appearing in the file LICENSE.GPL3
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-3.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/
#include <QtCharts/QBarCategoryAxis>
#include <private/qbarcategoryaxis_p.h>
#include <private/chartbarcategoryaxisx_p.h>
#include <private/chartbarcategoryaxisy_p.h>
#include <private/abstractdomain_p.h>
#include <QtCharts/QChart>
#include <QtCore/QtMath>
QT_CHARTS_BEGIN_NAMESPACE
/*!
\class QBarCategoryAxis
\inmodule Qt Charts
\brief The QBarCategoryAxis class is used for manipulating chart's axis.
QBarCategoryAxis 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
*/
/*!
\qmltype BarCategoryAxis
\instantiates QBarCategoryAxis
\inqmlmodule QtCharts
\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 string BarCategoryAxis::min
Defines the minimum value on the axis.
*/
/*!
\property QBarCategoryAxis::max
Defines the maximum value on the axis.
*/
/*!
\qmlproperty string BarCategoryAxis::max
Defines the maximum value on the axis.
*/
/*!
\property QBarCategoryAxis::count
The count of categories.
*/
/*!
\qmlproperty int BarCategoryAxis::count
The count of categories.
*/
/*!
\fn void QBarCategoryAxis::categoriesChanged()
Axis emits signal when the categories of the axis have 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::countChanged()
Axis emits signal when the count of categories has changed.
*/
/*!
\qmlsignal BarCategoryAxis::onCountChanged()
Axis emits signal when the count of categories 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.
*/
/*!
\qmlmethod void BarCategoryAxis::clear()
Removes all categories. Sets the maximum and minimum of the axis's range to QString::null.
*/
/*!
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_chart)
d->m_chart->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();
emit countChanged();
}
/*!
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();
emit countChanged();
}
/*!
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();
}
} else {
setRange(QString::null, QString::null);
}
emit categoriesChanged();
emit countChanged();
}
}
/*!
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();
}
emit categoriesChanged();
emit countChanged();
}
/*!
Replaces \a oldCategory with \a newCategory. If \a oldCategory does not exist on the axis nothing is done.
A \a newCategory 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);
emit categoriesChanged();
emit countChanged();
}
}
/*!
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();
emit countChanged();
}
/*!
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);
d->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);
d->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);
d->setRange(minCategory,maxCategory);
}
/*!
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)
{
QString value1 = min.toString();
QString value2 = max.toString();
setRange(value1, value2);
}
void QBarCategoryAxisPrivate::setRange(qreal min, qreal max)
{
Q_Q(QBarCategoryAxis);
bool categoryChanged = false;
bool changed = false;
if (min > max)
return;
if (!qFuzzyIsNull(m_min - min)) {
m_min = min;
changed = true;
int imin = m_min + 0.5;
if (imin >= 0 && imin < m_categories.count()) {
QString minCategory = m_categories.at(imin);
if (m_minCategory != minCategory && !minCategory.isEmpty()) {
m_minCategory = minCategory;
categoryChanged = true;
emit q->minChanged(minCategory);
}
}
}
if (!qFuzzyIsNull(m_max - max)) {
m_max = max;
changed = true;
int imax = m_max - 0.5;
if (imax >= 0 && imax < m_categories.count()) {
QString maxCategory = m_categories.at(imax);
if (m_maxCategory != maxCategory && !maxCategory.isEmpty()) {
m_maxCategory = maxCategory;
categoryChanged = true;
emit q->maxChanged(maxCategory);
}
}
}
if (categoryChanged){
emit q->rangeChanged(m_minCategory, m_maxCategory);
}
if (changed) {
emit rangeChanged(m_min,m_max);
}
}
void QBarCategoryAxisPrivate::setRange(const QString &minCategory, const QString &maxCategory)
{
Q_Q(QBarCategoryAxis);
bool changed = false;
//special case in case or clearing all categories
if (minCategory.isNull() && maxCategory.isNull()) {
m_minCategory = minCategory;
m_maxCategory = maxCategory;
m_min = 0;
m_max = 0;
m_count = 0;
emit q->minChanged(minCategory);
emit q->maxChanged(maxCategory);
emit q->rangeChanged(m_minCategory, m_maxCategory);
emit rangeChanged(m_min,m_max);
return;
}
if (m_categories.indexOf(maxCategory) < m_categories.indexOf(minCategory))
return;
if (!minCategory.isNull() && (m_minCategory != minCategory || m_minCategory.isNull())
&& m_categories.contains(minCategory)) {
m_minCategory = minCategory;
m_min = m_categories.indexOf(m_minCategory) - 0.5;
changed = true;
emit q->minChanged(minCategory);
}
if (!maxCategory.isNull() && (m_maxCategory != maxCategory || m_maxCategory.isNull())
&& m_categories.contains(maxCategory)) {
m_maxCategory = maxCategory;
m_max = m_categories.indexOf(m_maxCategory) + 0.5;
changed = true;
emit q->maxChanged(maxCategory);
}
if (changed) {
m_count = m_max - m_min;
emit q->rangeChanged(m_minCategory, m_maxCategory);
emit rangeChanged(m_min,m_max);
}
}
void QBarCategoryAxisPrivate::initializeGraphics(QGraphicsItem* parent)
{
Q_Q(QBarCategoryAxis);
ChartAxisElement* axis(0);
if (orientation() == Qt::Vertical)
axis = new ChartBarCategoryAxisY(q,parent);
if (orientation() == Qt::Horizontal)
axis = new ChartBarCategoryAxisX(q,parent);
m_item.reset(axis);
QAbstractAxisPrivate::initializeGraphics(parent);
}
void QBarCategoryAxisPrivate::updateCategoryDomain()
{
bool changed = false;
qreal tmpMin = m_categories.indexOf(m_minCategory) - 0.5;
if (!qFuzzyIsNull(m_min - tmpMin)) {
m_min = tmpMin;
changed = true;
}
qreal tmpMax = m_categories.indexOf(m_maxCategory) + 0.5;
if (!qFuzzyIsNull(m_max - tmpMax)) {
m_max = tmpMax;
changed = true;
}
m_count = m_max - m_min;
if (changed)
emit rangeChanged(m_min,m_max);
}
void QBarCategoryAxisPrivate::initializeDomain(AbstractDomain *domain)
{
Q_Q(QBarCategoryAxis);
if (m_max == m_min) {
int min;
int max;
if (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 (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"
QT_CHARTS_END_NAMESPACE