qdatetimeaxis.cpp
398 lines
| 10.9 KiB
| text/x-c
|
CppLexer
Miikka Heikkinen
|
r2854 | /**************************************************************************** | ||
Marek Rosa
|
r1717 | ** | ||
|
Miikka Heikkinen
|
r2854 | ** Copyright (C) 2016 The Qt Company Ltd. | ||
| ** Contact: https://www.qt.io/licensing/ | ||||
|
Marek Rosa
|
r1717 | ** | ||
|
Miikka Heikkinen
|
r2854 | ** This file is part of the Qt Charts module of the Qt Toolkit. | ||
|
Marek Rosa
|
r1717 | ** | ||
|
Miikka Heikkinen
|
r2854 | ** $QT_BEGIN_LICENSE:GPL$ | ||
Titta Heikkala
|
r2845 | ** 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 | ||||
|
Miikka Heikkinen
|
r2854 | ** 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. | ||||
|
Marek Rosa
|
r1717 | ** | ||
|
Titta Heikkala
|
r2845 | ** $QT_END_LICENSE$ | ||
| ** | ||||
|
Miikka Heikkinen
|
r2854 | ****************************************************************************/ | ||
|
Marek Rosa
|
r1717 | |||
|
Titta Heikkala
|
r2714 | #include <QtCharts/QDateTimeAxis> | ||
| #include <private/qdatetimeaxis_p.h> | ||||
| #include <private/chartdatetimeaxisx_p.h> | ||||
| #include <private/chartdatetimeaxisy_p.h> | ||||
| #include <private/polarchartdatetimeaxisangular_p.h> | ||||
| #include <private/polarchartdatetimeaxisradial_p.h> | ||||
| #include <private/abstractdomain_p.h> | ||||
| #include <QtCharts/QChart> | ||||
Michal Klocek
|
r2125 | #include <float.h> | ||
|
Marek Rosa
|
r1717 | #include <cmath> | ||
Titta Heikkala
|
r2712 | QT_CHARTS_BEGIN_NAMESPACE | ||
|
Marek Rosa
|
r1717 | /*! | ||
| \class QDateTimeAxis | ||||
|
Titta Heikkala
|
r2639 | \inmodule Qt Charts | ||
|
Marek Rosa
|
r1717 | \brief The QDateTimeAxis class is used for manipulating chart's axis. | ||
|
Marek Rosa
|
r1801 | The labels can be configured by setting an appropriate DateTime format. | ||
Miikka Heikkinen
|
r2494 | QDateTimeAxis works correctly with dates from 4714 BCE to 287396 CE. | ||
| There are also other limitiation related to QDateTime. Please refer to QDateTime documentation. | ||||
|
Marek Rosa
|
r1801 | QDateTimeAxis can be setup to show axis line with tick marks, grid lines and shades. | ||
|
Marek Rosa
|
r1882 | |||
|
Marek Rosa
|
r2396 | Note: QDateTimeAxis is disabled on ARM architecture. | ||
|
Marek Rosa
|
r1984 | |||
|
Marek Rosa
|
r1887 | \image api_datatime_axis.png | ||
|
Miikka Heikkinen
|
r2494 | QDateTimeAxis can be used with any QXYSeries. | ||
|
Marek Rosa
|
r1984 | To add a data point to the series QDateTime::toMSecsSinceEpoch() is used. | ||
|
Marek Rosa
|
r1882 | \code | ||
| QLineSeries *series = new QLineSeries; | ||||
| QDateTime xValue; | ||||
| xValue.setDate(QDate(2012, 1 , 18)); | ||||
| xValue.setTime(QTime(9, 34)); | ||||
|
Marek Rosa
|
r1984 | qreal yValue = 12; | ||
| series->append(xValue.toMSecsSinceEpoch(), yValue); | ||||
|
Marek Rosa
|
r1882 | |||
| xValue.setDate(QDate(2013, 5 , 11)); | ||||
| xValue.setTime(QTime(11, 14)); | ||||
|
Marek Rosa
|
r1984 | qreal yValue = 22; | ||
| series->append(xValue.toMSecsSinceEpoch(), yValue); | ||||
| \endcode | ||||
| Adding the series to the chart and setting up the QDateTimeAxis. | ||||
| \code | ||||
Jani Honkonen
|
r2097 | QChartView *chartView = new QChartView; | ||
|
Marek Rosa
|
r1882 | chartView->chart()->addSeries(series); | ||
| // ... | ||||
| QDateTimeAxis *axisX = new QDateTimeAxis; | ||||
| axisX->setFormat("dd-MM-yyyy h:mm"); | ||||
|
Marek Rosa
|
r2108 | chartView->chart()->setAxisX(axisX, series); | ||
|
Marek Rosa
|
r1882 | \endcode | ||
|
Marek Rosa
|
r1717 | */ | ||
|
Titta Heikkala
|
r2639 | /*! | ||
| \qmltype DateTimeAxis | ||||
| \instantiates QDateTimeAxis | ||||
|
Titta Heikkala
|
r2712 | \inqmlmodule QtCharts | ||
|
Titta Heikkala
|
r2639 | |||
|
Titta Heikkala
|
r2712 | \brief The DateTimeAxis element is used for manipulating chart's axes. | ||
| \inherits AbstractAxis | ||||
|
Marek Rosa
|
r1801 | |||
|
Titta Heikkala
|
r2712 | The labels can be configured by setting an appropriate DateTime format. | ||
| Note that any date before 4714 BCE or after about 1.4 million CE may not be accurately stored. | ||||
| DateTimeAxis can be setup to show axis line with tick marks, grid lines and shades. | ||||
|
Marek Rosa
|
r1717 | */ | ||
| /*! | ||||
| \property QDateTimeAxis::min | ||||
| Defines the minimum value on the axis. | ||||
|
Marek Rosa
|
r1730 | When setting this property the max is adjusted if necessary, to ensure that the range remains valid. | ||
|
Marek Rosa
|
r1717 | */ | ||
| /*! | ||||
|
Titta Heikkala
|
r2686 | \qmlproperty datetime DateTimeAxis::min | ||
|
Marek Rosa
|
r1717 | Defines the minimum value on the axis. | ||
|
Marek Rosa
|
r1730 | When setting this property the max is adjusted if necessary, to ensure that the range remains valid. | ||
|
Marek Rosa
|
r1717 | */ | ||
| /*! | ||||
| \property QDateTimeAxis::max | ||||
| Defines the maximum value on the axis. | ||||
|
Marek Rosa
|
r1730 | When setting this property the min is adjusted if necessary, to ensure that the range remains valid. | ||
|
Marek Rosa
|
r1717 | */ | ||
| /*! | ||||
|
Titta Heikkala
|
r2686 | \qmlproperty datetime DateTimeAxis::max | ||
|
Marek Rosa
|
r1717 | Defines the maximum value on the axis. | ||
|
Marek Rosa
|
r1730 | When setting this property the min is adjusted if necessary, to ensure that the range remains valid. | ||
|
Marek Rosa
|
r1717 | */ | ||
| /*! | ||||
|
Marek Rosa
|
r1731 | \fn void QDateTimeAxis::minChanged(QDateTime min) | ||
|
Marek Rosa
|
r1717 | Axis emits signal when \a min of axis has changed. | ||
| */ | ||||
| /*! | ||||
|
Titta Heikkala
|
r2686 | \qmlsignal DateTimeAxis::onMinChanged(datetime min) | ||
|
Marek Rosa
|
r1717 | Axis emits signal when \a min of axis has changed. | ||
| */ | ||||
| /*! | ||||
|
Marek Rosa
|
r1731 | \fn void QDateTimeAxis::maxChanged(QDateTime max) | ||
|
Marek Rosa
|
r1717 | Axis emits signal when \a max of axis has changed. | ||
| */ | ||||
| /*! | ||||
|
Titta Heikkala
|
r2686 | \qmlsignal DateTimeAxis::onMaxChanged(datetime max) | ||
|
Marek Rosa
|
r1717 | Axis emits signal when \a max of axis has changed. | ||
| */ | ||||
| /*! | ||||
|
Marek Rosa
|
r1731 | \fn void QDateTimeAxis::rangeChanged(QDateTime min, QDateTime max) | ||
|
Marek Rosa
|
r1717 | Axis emits signal when \a min or \a max of axis has changed. | ||
| */ | ||||
| /*! | ||||
|
Marek Rosa
|
r1812 | \property QDateTimeAxis::tickCount | ||
|
Marek Rosa
|
r1717 | The number of tick marks for the axis. | ||
| */ | ||||
| /*! | ||||
Tero Ahola
|
r2027 | \qmlproperty int DateTimeAxis::tickCount | ||
|
Marek Rosa
|
r1717 | The number of tick marks for the axis. | ||
| */ | ||||
|
Tero Ahola
|
r2027 | /*! | ||
| \property QDateTimeAxis::format | ||||
| The format string that is used when creating label for the axis out of a QDateTime object. | ||||
| Check QDateTime documentation for information on how the string should be defined. | ||||
|
Miikka Heikkinen
|
r2708 | |||
| \sa QChart::locale | ||||
|
Tero Ahola
|
r2027 | */ | ||
| /*! | ||||
| \qmlproperty string DateTimeAxis::format | ||||
| The format string that is used when creating label for the axis out of a QDateTime object. | ||||
| Check QDateTime documentation for information on how the string should be defined. | ||||
| */ | ||||
|
Marek Rosa
|
r2339 | /*! | ||
| \fn void QDateTimeAxis::tickCountChanged(int tickCount) | ||||
| Axis emits signal when \a tickCount number on axis have changed. | ||||
| */ | ||||
| /*! | ||||
| \qmlsignal DateTimeAxis::tickCountChanged(int tickCount) | ||||
| Axis emits signal when \a tickCount number on axis have changed. | ||||
| */ | ||||
|
Tero Ahola
|
r2027 | /*! | ||
| \fn void QDateTimeAxis::formatChanged(QString format) | ||||
| Axis emits signal when \a format of the axis has changed. | ||||
| */ | ||||
| /*! | ||||
| \qmlsignal DateTimeAxis::onFormatChanged(string format) | ||||
| Axis emits signal when \a format of the axis has changed. | ||||
| */ | ||||
|
Marek Rosa
|
r1717 | /*! | ||
| Constructs an axis object which is a child of \a parent. | ||||
| */ | ||||
| QDateTimeAxis::QDateTimeAxis(QObject *parent) : | ||||
|
Jani Honkonen
|
r2097 | QAbstractAxis(*new QDateTimeAxisPrivate(this), parent) | ||
|
Marek Rosa
|
r1717 | { | ||
| } | ||||
| /*! | ||||
| \internal | ||||
| */ | ||||
|
Jani Honkonen
|
r2097 | QDateTimeAxis::QDateTimeAxis(QDateTimeAxisPrivate &d, QObject *parent) : QAbstractAxis(d, parent) | ||
|
Marek Rosa
|
r1717 | { | ||
| } | ||||
| /*! | ||||
|
Titta Heikkala
|
r2686 | Destroys the object. | ||
|
Marek Rosa
|
r1717 | */ | ||
| QDateTimeAxis::~QDateTimeAxis() | ||||
| { | ||||
|
Michal Klocek
|
r2273 | Q_D(QDateTimeAxis); | ||
| if (d->m_chart) | ||||
| d->m_chart->removeAxis(this); | ||||
|
Marek Rosa
|
r1717 | } | ||
| void QDateTimeAxis::setMin(QDateTime min) | ||||
| { | ||||
| Q_D(QDateTimeAxis); | ||||
|
Marek Rosa
|
r1728 | if (min.isValid()) | ||
|
Michal Klocek
|
r2273 | d->setRange(min.toMSecsSinceEpoch(), qMax(d->m_max, qreal(min.toMSecsSinceEpoch()))); | ||
|
Marek Rosa
|
r1717 | } | ||
| QDateTime QDateTimeAxis::min() const | ||||
| { | ||||
| Q_D(const QDateTimeAxis); | ||||
|
Michal Klocek
|
r2273 | return QDateTime::fromMSecsSinceEpoch(d->m_min); | ||
|
Marek Rosa
|
r1717 | } | ||
| void QDateTimeAxis::setMax(QDateTime max) | ||||
| { | ||||
| Q_D(QDateTimeAxis); | ||||
|
Marek Rosa
|
r1728 | if (max.isValid()) | ||
|
Michal Klocek
|
r2273 | d->setRange(qMin(d->m_min, qreal(max.toMSecsSinceEpoch())), max.toMSecsSinceEpoch()); | ||
|
Marek Rosa
|
r1717 | } | ||
| QDateTime QDateTimeAxis::max() const | ||||
| { | ||||
| Q_D(const QDateTimeAxis); | ||||
|
Michal Klocek
|
r2273 | return QDateTime::fromMSecsSinceEpoch(d->m_max); | ||
|
Marek Rosa
|
r1717 | } | ||
| /*! | ||||
| Sets range from \a min to \a max on the axis. | ||||
|
Marek Rosa
|
r1730 | If min is greater than max then this function returns without making any changes. | ||
|
Marek Rosa
|
r1717 | */ | ||
| void QDateTimeAxis::setRange(QDateTime min, QDateTime max) | ||||
| { | ||||
| Q_D(QDateTimeAxis); | ||||
|
Marek Rosa
|
r1728 | if (!min.isValid() || !max.isValid() || min > max) | ||
| return; | ||||
|
Marek Rosa
|
r1717 | |||
|
Michal Klocek
|
r2273 | d->setRange(min.toMSecsSinceEpoch(),max.toMSecsSinceEpoch()); | ||
|
Marek Rosa
|
r1717 | } | ||
|
Marek Rosa
|
r1801 | void QDateTimeAxis::setFormat(QString format) | ||
|
Marek Rosa
|
r1717 | { | ||
| Q_D(QDateTimeAxis); | ||||
|
Tero Ahola
|
r2027 | if (d->m_format != format) { | ||
| d->m_format = format; | ||||
| emit formatChanged(format); | ||||
| } | ||||
|
Marek Rosa
|
r1717 | } | ||
|
Marek Rosa
|
r1801 | QString QDateTimeAxis::format() const | ||
|
Marek Rosa
|
r1717 | { | ||
| Q_D(const QDateTimeAxis); | ||||
| return d->m_format; | ||||
| } | ||||
| /*! | ||||
| Sets \a count for ticks on the axis. | ||||
| */ | ||||
|
Marek Rosa
|
r1801 | void QDateTimeAxis::setTickCount(int count) | ||
|
Jani Honkonen
|
r2097 | { | ||
|
Marek Rosa
|
r1717 | Q_D(QDateTimeAxis); | ||
|
Jani Honkonen
|
r2097 | if (d->m_tickCount != count && count >= 2) { | ||
|
Marek Rosa
|
r1717 | d->m_tickCount = count; | ||
|
Michal Klocek
|
r2273 | emit tickCountChanged(count); | ||
|
Marek Rosa
|
r1717 | } | ||
| } | ||||
| /*! | ||||
|
Marek Rosa
|
r1812 | \fn int QDateTimeAxis::tickCount() const | ||
|
Titta Heikkala
|
r2686 | Return number of ticks on the axis. | ||
|
Marek Rosa
|
r1717 | */ | ||
|
Marek Rosa
|
r1801 | int QDateTimeAxis::tickCount() const | ||
|
Marek Rosa
|
r1717 | { | ||
| Q_D(const QDateTimeAxis); | ||||
| return d->m_tickCount; | ||||
| } | ||||
| /*! | ||||
|
Titta Heikkala
|
r2686 | Returns the type of the axis. | ||
|
Marek Rosa
|
r1717 | */ | ||
| QAbstractAxis::AxisType QDateTimeAxis::type() const | ||||
| { | ||||
| return AxisTypeDateTime; | ||||
| } | ||||
| ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||||
|
Jani Honkonen
|
r2104 | QDateTimeAxisPrivate::QDateTimeAxisPrivate(QDateTimeAxis *q) | ||
| : QAbstractAxisPrivate(q), | ||||
|
Michal Klocek
|
r2273 | m_min(0), | ||
| m_max(0), | ||||
|
Jani Honkonen
|
r2104 | m_tickCount(5) | ||
|
Marek Rosa
|
r1717 | { | ||
|
Titta Heikkala
|
r2712 | m_format = QStringLiteral("dd-MM-yyyy\nh:mm"); | ||
|
Marek Rosa
|
r1717 | } | ||
| QDateTimeAxisPrivate::~QDateTimeAxisPrivate() | ||||
| { | ||||
| } | ||||
|
Michal Klocek
|
r2273 | void QDateTimeAxisPrivate::setRange(qreal min,qreal max) | ||
|
Marek Rosa
|
r1717 | { | ||
| Q_Q(QDateTimeAxis); | ||||
|
Michal Klocek
|
r2273 | bool changed = false; | ||
| if (m_min != min) { | ||||
| m_min = min; | ||||
| changed = true; | ||||
| emit q->minChanged(QDateTime::fromMSecsSinceEpoch(min)); | ||||
| } | ||||
| if (m_max != max) { | ||||
| m_max = max; | ||||
| changed = true; | ||||
| emit q->maxChanged(QDateTime::fromMSecsSinceEpoch(max)); | ||||
| } | ||||
| if (changed) { | ||||
| emit q->rangeChanged(QDateTime::fromMSecsSinceEpoch(min), QDateTime::fromMSecsSinceEpoch(max)); | ||||
| emit rangeChanged(m_min,m_max); | ||||
| } | ||||
|
Marek Rosa
|
r1717 | } | ||
| void QDateTimeAxisPrivate::setMin(const QVariant &min) | ||||
| { | ||||
| Q_Q(QDateTimeAxis); | ||||
| if (min.canConvert(QVariant::DateTime)) | ||||
| q->setMin(min.toDateTime()); | ||||
| } | ||||
| void QDateTimeAxisPrivate::setMax(const QVariant &max) | ||||
| { | ||||
| Q_Q(QDateTimeAxis); | ||||
| if (max.canConvert(QVariant::DateTime)) | ||||
| q->setMax(max.toDateTime()); | ||||
| } | ||||
| void QDateTimeAxisPrivate::setRange(const QVariant &min, const QVariant &max) | ||||
| { | ||||
| Q_Q(QDateTimeAxis); | ||||
| if (min.canConvert(QVariant::DateTime) && max.canConvert(QVariant::DateTime)) | ||||
| q->setRange(min.toDateTime(), max.toDateTime()); | ||||
| } | ||||
|
Michal Klocek
|
r2273 | void QDateTimeAxisPrivate::initializeGraphics(QGraphicsItem* parent) | ||
|
Marek Rosa
|
r1717 | { | ||
| Q_Q(QDateTimeAxis); | ||||
|
Miikka Heikkinen
|
r2483 | ChartAxisElement *axis(0); | ||
| if (m_chart->chartType() == QChart::ChartTypeCartesian) { | ||||
| if (orientation() == Qt::Vertical) | ||||
| axis = new ChartDateTimeAxisY(q,parent); | ||||
| if (orientation() == Qt::Horizontal) | ||||
| axis = new ChartDateTimeAxisX(q,parent); | ||||
| } | ||||
| if (m_chart->chartType() == QChart::ChartTypePolar) { | ||||
| if (orientation() == Qt::Vertical) | ||||
| axis = new PolarChartDateTimeAxisRadial(q, parent); | ||||
| if (orientation() == Qt::Horizontal) | ||||
| axis = new PolarChartDateTimeAxisAngular(q, parent); | ||||
| } | ||||
|
Michal Klocek
|
r2273 | |||
| m_item.reset(axis); | ||||
| QAbstractAxisPrivate::initializeGraphics(parent); | ||||
|
Marek Rosa
|
r1717 | } | ||
|
Marek Rosa
|
r2275 | void QDateTimeAxisPrivate::initializeDomain(AbstractDomain *domain) | ||
|
Marek Rosa
|
r1717 | { | ||
|
Jani Honkonen
|
r2097 | if (m_max == m_min) { | ||
|
Michal Klocek
|
r2273 | if (orientation() == Qt::Vertical) | ||
| setRange(domain->minY(), domain->maxY()); | ||||
|
Jani Honkonen
|
r2097 | else | ||
|
Michal Klocek
|
r2273 | setRange(domain->minX(), domain->maxX()); | ||
|
Marek Rosa
|
r1717 | } else { | ||
|
Michal Klocek
|
r2273 | if (orientation() == Qt::Vertical) | ||
| domain->setRangeY(m_min, m_max); | ||||
|
Jani Honkonen
|
r2097 | else | ||
|
Michal Klocek
|
r2273 | domain->setRangeX(m_min, m_max); | ||
|
Marek Rosa
|
r1717 | } | ||
| } | ||||
| #include "moc_qdatetimeaxis.cpp" | ||||
| #include "moc_qdatetimeaxis_p.cpp" | ||||
|
Titta Heikkala
|
r2712 | QT_CHARTS_END_NAMESPACE | ||