qvalueaxis.cpp
466 lines
| 12.3 KiB
| text/x-c
|
CppLexer
|
r0 | /**************************************************************************** | ||
** | ||||
** 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/QValueAxis> | ||||
#include <private/qvalueaxis_p.h> | ||||
#include <private/chartvalueaxisx_p.h> | ||||
#include <private/chartvalueaxisy_p.h> | ||||
#include <private/abstractdomain_p.h> | ||||
#include <private/polarchartvalueaxisangular_p.h> | ||||
#include <private/polarchartvalueaxisradial_p.h> | ||||
#include <private/chartdataset_p.h> | ||||
#include <private/chartpresenter_p.h> | ||||
#include <private/charttheme_p.h> | ||||
QT_CHARTS_BEGIN_NAMESPACE | ||||
/*! | ||||
\class QValueAxis | ||||
\inmodule Qt Charts | ||||
\brief The QValueAxis class is used for manipulating chart's axis. | ||||
ValueAxis can be setup to show axis line with tick marks, grid lines and shades. | ||||
Values of axis are drawn to position of ticks. | ||||
Example code on how to use QValueAxis. | ||||
\code | ||||
QChartView *chartView = new QChartView; | ||||
QLineSeries *series = new QLineSeries; | ||||
// ... | ||||
chartView->chart()->addSeries(series); | ||||
QValueAxis *axisX = new QValueAxis; | ||||
axisX->setRange(10, 20.5); | ||||
axisX->setTickCount(10); | ||||
axisX->setLabelFormat("%.2f"); | ||||
chartView->chart()->setAxisX(axisX, series); | ||||
\endcode | ||||
*/ | ||||
/*! | ||||
\qmltype ValueAxis | ||||
\instantiates QValueAxis | ||||
\inqmlmodule QtCharts | ||||
\inherits AbstractAxis | ||||
\brief The ValueAxis element is used for manipulating chart's axes | ||||
ValueAxis can be setup to show axis line with tick marks, grid lines and shades. | ||||
Values of axis are drawn to position of ticks | ||||
Example about using ValueAxis: | ||||
\code | ||||
ChartView { | ||||
ValueAxis { | ||||
id: xAxis | ||||
min: 0 | ||||
max: 10 | ||||
} | ||||
// Add a few series... | ||||
} | ||||
\endcode | ||||
*/ | ||||
/*! | ||||
\property QValueAxis::min | ||||
Defines the minimum value on the axis. | ||||
When setting this property the max is adjusted if necessary, to ensure that the range remains valid. | ||||
*/ | ||||
/*! | ||||
\qmlproperty real ValueAxis::min | ||||
Defines the minimum value on the axis. | ||||
When setting this property the max is adjusted if necessary, to ensure that the range remains valid. | ||||
*/ | ||||
/*! | ||||
\property QValueAxis::max | ||||
Defines the maximum value on the axis. | ||||
When setting this property the min is adjusted if necessary, to ensure that the range remains valid. | ||||
*/ | ||||
/*! | ||||
\qmlproperty real ValueAxis::max | ||||
Defines the maximum value on the axis. | ||||
When setting this property the min is adjusted if necessary, to ensure that the range remains valid. | ||||
*/ | ||||
/*! | ||||
\property QValueAxis::tickCount | ||||
Defines the number of ticks on the axis. This indicates how many grid lines are drawn on the | ||||
chart. The default value is 5, and it can not be below 2. | ||||
*/ | ||||
/*! | ||||
\qmlproperty int ValueAxis::tickCount | ||||
Defines the number of ticks on the axis. This indicates how many grid lines are drawn on the | ||||
chart. The default value is 5, and it can not be below 2. | ||||
*/ | ||||
/*! | ||||
\property QValueAxis::minorTickCount | ||||
Defines the number of minor ticks on the axis. This indicates how many grid lines are drawn | ||||
between major ticks on the chart. Labels are not drawn for minor ticks. The default value is 0. | ||||
*/ | ||||
/*! | ||||
\qmlproperty int ValueAxis::minorTickCount | ||||
Defines the number of minor ticks on the axis. This indicates how many grid lines are drawn | ||||
between major ticks on the chart. Labels are not drawn for minor ticks. The default value is 0. | ||||
*/ | ||||
/*! | ||||
\property QValueAxis::labelFormat | ||||
Defines the label format of the axis. | ||||
Supported specifiers are: d, i, o, x, X, f, F, e, E, g, G, and c. | ||||
See QString::sprintf() for additional details. | ||||
If the QChart::localizeNumbers is \c{true}, the supported specifiers are limited to: d, e, E, f, | ||||
g, G, and i. Also, only the precision modifier is supported. The rest of the formatting comes from | ||||
the default QLocale of the application. | ||||
*/ | ||||
/*! | ||||
\qmlproperty real ValueAxis::labelFormat | ||||
Defines the label format of the axis. | ||||
Supported specifiers are: d, i, o, x, X, f, F, e, E, g, G, and c. | ||||
See QString::sprintf() for additional details. | ||||
If the ChartView::localizeNumbers is \c{true}, the supported specifiers are limited to: d, e, E, f, | ||||
g, G, and i. Also, only the precision modifier is supported. The rest of the formatting comes from | ||||
the default QLocale of the application. | ||||
*/ | ||||
/*! | ||||
\fn void QValueAxis::minChanged(qreal min) | ||||
Axis emits signal when \a min of axis has changed. | ||||
*/ | ||||
/*! | ||||
\qmlsignal ValueAxis::onMinChanged(real min) | ||||
Axis emits signal when \a min of axis has changed. | ||||
*/ | ||||
/*! | ||||
\fn void QValueAxis::maxChanged(qreal max) | ||||
Axis emits signal when \a max of axis has changed. | ||||
*/ | ||||
/*! | ||||
\qmlsignal ValueAxis::onMaxChanged(real max) | ||||
Axis emits signal when \a max of axis has changed. | ||||
*/ | ||||
/*! | ||||
\fn void QValueAxis::tickCountChanged(int tickCount) | ||||
Axis emits signal when \a tickCount of axis has changed. | ||||
*/ | ||||
/*! | ||||
\qmlsignal ValueAxis::tickCountChanged(int tickCount) | ||||
Axis emits signal when \a tickCount of axis has changed. | ||||
*/ | ||||
/*! | ||||
\fn void QValueAxis::minorTickCountChanged(int minorTickCount) | ||||
Axis emits signal when \a minorTickCount of axis has changed. | ||||
*/ | ||||
/*! | ||||
\qmlsignal ValueAxis::minorTickCountChanged(int minorTickCount) | ||||
Axis emits signal when \a minorTickCount of axis has changed. | ||||
*/ | ||||
/*! | ||||
\fn void QValueAxis::rangeChanged(qreal min, qreal max) | ||||
Axis emits signal when \a min or \a max of axis has changed. | ||||
*/ | ||||
/*! | ||||
\fn void QValueAxis::labelFormatChanged(const QString &format) | ||||
Axis emits signal when \a format of axis labels has changed. | ||||
*/ | ||||
/*! | ||||
\qmlsignal ValueAxis::labelFormatChanged(const QString &format) | ||||
Axis emits signal when \a format of axis labels has changed. | ||||
*/ | ||||
/*! | ||||
Constructs an axis object which is a child of \a parent. | ||||
*/ | ||||
QValueAxis::QValueAxis(QObject *parent) : | ||||
QAbstractAxis(*new QValueAxisPrivate(this), parent) | ||||
{ | ||||
} | ||||
/*! | ||||
\internal | ||||
*/ | ||||
QValueAxis::QValueAxis(QValueAxisPrivate &d, QObject *parent) | ||||
: QAbstractAxis(d, parent) | ||||
{ | ||||
} | ||||
/*! | ||||
Destroys the object | ||||
*/ | ||||
QValueAxis::~QValueAxis() | ||||
{ | ||||
Q_D(QValueAxis); | ||||
if (d->m_chart) | ||||
d->m_chart->removeAxis(this); | ||||
} | ||||
void QValueAxis::setMin(qreal min) | ||||
{ | ||||
Q_D(QValueAxis); | ||||
setRange(min, qMax(d->m_max, min)); | ||||
} | ||||
qreal QValueAxis::min() const | ||||
{ | ||||
Q_D(const QValueAxis); | ||||
return d->m_min; | ||||
} | ||||
void QValueAxis::setMax(qreal max) | ||||
{ | ||||
Q_D(QValueAxis); | ||||
setRange(qMin(d->m_min, max), max); | ||||
} | ||||
qreal QValueAxis::max() const | ||||
{ | ||||
Q_D(const QValueAxis); | ||||
return d->m_max; | ||||
} | ||||
/*! | ||||
Sets range from \a min to \a max on the axis. | ||||
If min is greater than max then this function returns without making any changes. | ||||
*/ | ||||
void QValueAxis::setRange(qreal min, qreal max) | ||||
{ | ||||
Q_D(QValueAxis); | ||||
d->setRange(min,max); | ||||
} | ||||
void QValueAxis::setTickCount(int count) | ||||
{ | ||||
Q_D(QValueAxis); | ||||
if (d->m_tickCount != count && count >= 2) { | ||||
d->m_tickCount = count; | ||||
emit tickCountChanged(count); | ||||
} | ||||
} | ||||
int QValueAxis::tickCount() const | ||||
{ | ||||
Q_D(const QValueAxis); | ||||
return d->m_tickCount; | ||||
} | ||||
void QValueAxis::setMinorTickCount(int count) | ||||
{ | ||||
Q_D(QValueAxis); | ||||
if (d->m_minorTickCount != count && count >= 0) { | ||||
d->m_minorTickCount = count; | ||||
emit minorTickCountChanged(count); | ||||
} | ||||
} | ||||
int QValueAxis::minorTickCount() const | ||||
{ | ||||
Q_D(const QValueAxis); | ||||
return d->m_minorTickCount; | ||||
} | ||||
void QValueAxis::setLabelFormat(const QString &format) | ||||
{ | ||||
Q_D(QValueAxis); | ||||
d->m_format = format; | ||||
emit labelFormatChanged(format); | ||||
} | ||||
QString QValueAxis::labelFormat() const | ||||
{ | ||||
Q_D(const QValueAxis); | ||||
return d->m_format; | ||||
} | ||||
/*! | ||||
Returns the type of the axis | ||||
*/ | ||||
QAbstractAxis::AxisType QValueAxis::type() const | ||||
{ | ||||
return AxisTypeValue; | ||||
} | ||||
/*! | ||||
This method modifies range and number of ticks on the axis to look "nice". Algorithm considers numbers that | ||||
can be expressed as form of 1*10^n, 2* 10^n or 5*10^n as a nice numbers. These numbers are used for spacing the ticks. | ||||
This method will modify the current range and number of ticks. | ||||
\sa setRange(), setTickCount() | ||||
*/ | ||||
void QValueAxis::applyNiceNumbers() | ||||
{ | ||||
Q_D(QValueAxis); | ||||
if(d->m_applying) return; | ||||
qreal min = d->m_min; | ||||
qreal max = d->m_max; | ||||
int ticks = d->m_tickCount; | ||||
AbstractDomain::looseNiceNumbers(min,max,ticks); | ||||
d->m_applying=true; | ||||
d->setRange(min,max); | ||||
setTickCount(ticks); | ||||
d->m_applying=false; | ||||
} | ||||
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||||
QValueAxisPrivate::QValueAxisPrivate(QValueAxis *q) | ||||
: QAbstractAxisPrivate(q), | ||||
m_min(0), | ||||
m_max(0), | ||||
m_tickCount(5), | ||||
m_minorTickCount(0), | ||||
m_format(QString::null), | ||||
m_applying(false) | ||||
{ | ||||
} | ||||
QValueAxisPrivate::~QValueAxisPrivate() | ||||
{ | ||||
} | ||||
void QValueAxisPrivate::setMin(const QVariant &min) | ||||
{ | ||||
Q_Q(QValueAxis); | ||||
bool ok; | ||||
qreal value = min.toReal(&ok); | ||||
if (ok) | ||||
q->setMin(value); | ||||
} | ||||
void QValueAxisPrivate::setMax(const QVariant &max) | ||||
{ | ||||
Q_Q(QValueAxis); | ||||
bool ok; | ||||
qreal value = max.toReal(&ok); | ||||
if (ok) | ||||
q->setMax(value); | ||||
} | ||||
void QValueAxisPrivate::setRange(const QVariant &min, const QVariant &max) | ||||
{ | ||||
Q_Q(QValueAxis); | ||||
bool ok1; | ||||
bool ok2; | ||||
qreal value1 = min.toReal(&ok1); | ||||
qreal value2 = max.toReal(&ok2); | ||||
if (ok1 && ok2) | ||||
q->setRange(value1, value2); | ||||
} | ||||
void QValueAxisPrivate::setRange(qreal min, qreal max) | ||||
{ | ||||
Q_Q(QValueAxis); | ||||
bool changed = false; | ||||
if (min > max) | ||||
return; | ||||
bool changeMin = false; | ||||
if (m_min == 0 || min == 0) | ||||
changeMin = !qFuzzyCompare(1 + m_min, 1 + min); | ||||
else | ||||
changeMin = !qFuzzyCompare(m_min, min); | ||||
bool changeMax = false; | ||||
if (m_max == 0 || max == 0) | ||||
changeMax = !qFuzzyCompare(1 + m_max, 1 + max); | ||||
else | ||||
changeMax = !qFuzzyCompare(m_max, max); | ||||
if (changeMin) { | ||||
m_min = min; | ||||
changed = true; | ||||
emit q->minChanged(min); | ||||
} | ||||
if (changeMax) { | ||||
m_max = max; | ||||
changed = true; | ||||
emit q->maxChanged(max); | ||||
} | ||||
if (changed) { | ||||
emit rangeChanged(min,max); | ||||
emit q->rangeChanged(min, max); | ||||
} | ||||
} | ||||
void QValueAxisPrivate::initializeGraphics(QGraphicsItem *parent) | ||||
{ | ||||
Q_Q(QValueAxis); | ||||
ChartAxisElement *axis(0); | ||||
if (m_chart->chartType() == QChart::ChartTypeCartesian) { | ||||
if (orientation() == Qt::Vertical) | ||||
axis = new ChartValueAxisY(q,parent); | ||||
if (orientation() == Qt::Horizontal) | ||||
axis = new ChartValueAxisX(q,parent); | ||||
} | ||||
if (m_chart->chartType() == QChart::ChartTypePolar) { | ||||
if (orientation() == Qt::Vertical) | ||||
axis = new PolarChartValueAxisRadial(q, parent); | ||||
if (orientation() == Qt::Horizontal) | ||||
axis = new PolarChartValueAxisAngular(q, parent); | ||||
} | ||||
m_item.reset(axis); | ||||
QAbstractAxisPrivate::initializeGraphics(parent); | ||||
} | ||||
void QValueAxisPrivate::initializeDomain(AbstractDomain *domain) | ||||
{ | ||||
if (orientation() == Qt::Vertical) { | ||||
if (!qFuzzyIsNull(m_max - m_min)) | ||||
domain->setRangeY(m_min, m_max); | ||||
else | ||||
setRange(domain->minY(), domain->maxY()); | ||||
} | ||||
if (orientation() == Qt::Horizontal) { | ||||
if (!qFuzzyIsNull(m_max - m_min)) | ||||
domain->setRangeX(m_min, m_max); | ||||
else | ||||
setRange(domain->minX(), domain->maxX()); | ||||
} | ||||
} | ||||
#include "moc_qvalueaxis.cpp" | ||||
#include "moc_qvalueaxis_p.cpp" | ||||
QT_CHARTS_END_NAMESPACE | ||||