qdatetimeaxis.cpp
343 lines
| 8.9 KiB
| text/x-c
|
CppLexer
Marek Rosa
|
r1717 | /**************************************************************************** | ||
| ** | ||||
| ** 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 "qdatetimeaxis.h" | ||||
| #include "qdatetimeaxis_p.h" | ||||
| #include "chartdatetimeaxisx_p.h" | ||||
| #include "chartdatetimeaxisy_p.h" | ||||
| #include "domain_p.h" | ||||
| #include <cmath> | ||||
| #include <QDebug> | ||||
| QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||||
| /*! | ||||
| \class QDateTimeAxis | ||||
| \brief The QDateTimeAxis class is used for manipulating chart's axis. | ||||
| \mainclass | ||||
|
Marek Rosa
|
r1801 | The labels can be configured by setting an appropriate DateTime format. | ||
|
Marek Rosa
|
r1834 | Note that any date before 4714 BCE or after about 1.4 million CE may not be accurately stored. | ||
|
Marek Rosa
|
r1801 | QDateTimeAxis can be setup to show axis line with tick marks, grid lines and shades. | ||
|
Marek Rosa
|
r1882 | |||
|
Marek Rosa
|
r1887 | \image api_datatime_axis.png | ||
|
Marek Rosa
|
r1882 | Example code on how to use QDateTimeAxis. | ||
| \code | ||||
| QChartView *chartView = new QChartView; | ||||
| QLineSeries *series = new QLineSeries; | ||||
| QDateTime xValue; | ||||
| xValue.setDate(QDate(2012, 1 , 18)); | ||||
| xValue.setTime(QTime(9, 34)); | ||||
| series->append(xValue.toMSecsSinceEpoch(), 12); | ||||
| xValue.setDate(QDate(2013, 5 , 11)); | ||||
| xValue.setTime(QTime(11, 14)); | ||||
| series->append(xValue.toMSecsSinceEpoch(), 22); | ||||
| chartView->chart()->addSeries(series); | ||||
| // ... | ||||
| QDateTimeAxis *axisX = new QDateTimeAxis; | ||||
| axisX->setFormat("dd-MM-yyyy h:mm"); | ||||
| chartView->chart()->setAxisX(series, axisX); | ||||
| \endcode | ||||
|
Marek Rosa
|
r1717 | */ | ||
| /*! | ||||
|
Marek Rosa
|
r1801 | \qmlclass DateTimeAxis QDateTimeAxis | ||
| \brief The DateTimeAxis element is used for manipulating chart's axes | ||||
| The labels can be configured by setting an appropriate DateTime format. | ||||
|
Marek Rosa
|
r1834 | Note that any date before 4714 BCE or after about 1.4 million CE may not be accurately stored. | ||
|
Marek Rosa
|
r1801 | 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 | */ | ||
| /*! | ||||
| \qmlproperty real ValuesAxis::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 | */ | ||
| /*! | ||||
| \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 | */ | ||
| /*! | ||||
| \qmlproperty real ValuesAxis::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 | */ | ||
| /*! | ||||
|
Marek Rosa
|
r1731 | \fn void QDateTimeAxis::minChanged(QDateTime min) | ||
|
Marek Rosa
|
r1717 | Axis emits signal when \a min of axis has changed. | ||
| */ | ||||
| /*! | ||||
|
Marek Rosa
|
r1731 | \qmlsignal ValuesAxis::onMinChanged(QDateTime 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. | ||
| */ | ||||
| /*! | ||||
|
Marek Rosa
|
r1731 | \qmlsignal ValuesAxis::onMaxChanged(QDateTime 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. | ||
| */ | ||||
| /*! | ||||
|
Marek Rosa
|
r1812 | \qmlproperty int ValuesAxis::tickCount | ||
|
Marek Rosa
|
r1717 | The number of tick marks for the axis. | ||
| */ | ||||
| /*! | ||||
| Constructs an axis object which is a child of \a parent. | ||||
| */ | ||||
| QDateTimeAxis::QDateTimeAxis(QObject *parent) : | ||||
| QAbstractAxis(*new QDateTimeAxisPrivate(this),parent) | ||||
| { | ||||
| } | ||||
| /*! | ||||
| \internal | ||||
| */ | ||||
| QDateTimeAxis::QDateTimeAxis(QDateTimeAxisPrivate &d,QObject *parent) : QAbstractAxis(d,parent) | ||||
| { | ||||
| } | ||||
| /*! | ||||
| Destroys the object | ||||
| */ | ||||
| QDateTimeAxis::~QDateTimeAxis() | ||||
| { | ||||
| } | ||||
| void QDateTimeAxis::setMin(QDateTime min) | ||||
| { | ||||
| Q_D(QDateTimeAxis); | ||||
|
Marek Rosa
|
r1728 | if (min.isValid()) | ||
| setRange(min, qMax(d->m_max, min)); | ||||
|
Marek Rosa
|
r1717 | } | ||
| QDateTime QDateTimeAxis::min() const | ||||
| { | ||||
| Q_D(const QDateTimeAxis); | ||||
| return d->m_min; | ||||
| } | ||||
| void QDateTimeAxis::setMax(QDateTime max) | ||||
| { | ||||
| Q_D(QDateTimeAxis); | ||||
|
Marek Rosa
|
r1728 | if (max.isValid()) | ||
| setRange(qMin(d->m_min, max), max); | ||||
|
Marek Rosa
|
r1717 | } | ||
| QDateTime QDateTimeAxis::max() const | ||||
| { | ||||
| Q_D(const QDateTimeAxis); | ||||
| return d->m_max; | ||||
| } | ||||
| /*! | ||||
| 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 | |||
|
Marek Rosa
|
r1728 | bool changed = false; | ||
|
Marek Rosa
|
r1717 | if (d->m_min != min) { | ||
| d->m_min = min; | ||||
| changed = true; | ||||
| emit minChanged(min); | ||||
| } | ||||
| if (d->m_max != max) { | ||||
| d->m_max = max; | ||||
| changed = true; | ||||
| emit maxChanged(max); | ||||
| } | ||||
| if (changed) { | ||||
| emit rangeChanged(d->m_min,d->m_max); | ||||
| d->emitUpdated(); | ||||
| } | ||||
| } | ||||
|
Marek Rosa
|
r1731 | /*! | ||
| Sets \a format string that is used when creating label for the axis out of the QDateTime object. | ||||
| Check QDateTime documentation for information on how the string should be defined. | ||||
|
Marek Rosa
|
r1812 | \sa format() | ||
|
Marek Rosa
|
r1731 | */ | ||
|
Marek Rosa
|
r1801 | void QDateTimeAxis::setFormat(QString format) | ||
|
Marek Rosa
|
r1717 | { | ||
| Q_D(QDateTimeAxis); | ||||
| d->m_format = format; | ||||
| } | ||||
|
Marek Rosa
|
r1731 | /*! | ||
| Returns the format string that is used when creating label for the axis out of the QDateTime object. | ||||
| Check QDateTime documentation for information on how the string should be defined. | ||||
|
Marek Rosa
|
r1812 | \sa setFormat() | ||
|
Marek Rosa
|
r1731 | */ | ||
|
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) | ||
|
Marek Rosa
|
r1717 | { | ||
| Q_D(QDateTimeAxis); | ||||
| if (d->m_tickCount != count && count >=2) { | ||||
| d->m_tickCount = count; | ||||
| d->emitUpdated(); | ||||
| } | ||||
| } | ||||
| /*! | ||||
|
Marek Rosa
|
r1812 | \fn int QDateTimeAxis::tickCount() const | ||
|
Marek Rosa
|
r1717 | Return number of ticks on the axis | ||
| */ | ||||
|
Marek Rosa
|
r1801 | int QDateTimeAxis::tickCount() const | ||
|
Marek Rosa
|
r1717 | { | ||
| Q_D(const QDateTimeAxis); | ||||
| return d->m_tickCount; | ||||
| } | ||||
| /*! | ||||
| Returns the type of the axis | ||||
| */ | ||||
| QAbstractAxis::AxisType QDateTimeAxis::type() const | ||||
| { | ||||
| return AxisTypeDateTime; | ||||
| } | ||||
| ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||||
| QDateTimeAxisPrivate::QDateTimeAxisPrivate(QDateTimeAxis* q): | ||||
| QAbstractAxisPrivate(q), | ||||
Jani Honkonen
|
r1921 | m_min(QDateTime::fromMSecsSinceEpoch(0)), | ||
| m_max(QDateTime::fromMSecsSinceEpoch(0)), | ||||
|
Marek Rosa
|
r1717 | m_tickCount(5) | ||
| { | ||||
|
Marek Rosa
|
r1887 | m_format = "dd-MM-yyyy\nh:mm"; | ||
|
Marek Rosa
|
r1717 | } | ||
| QDateTimeAxisPrivate::~QDateTimeAxisPrivate() | ||||
| { | ||||
| } | ||||
| void QDateTimeAxisPrivate::handleDomainUpdated() | ||||
| { | ||||
| Q_Q(QDateTimeAxis); | ||||
| Domain* domain = qobject_cast<Domain*>(sender()); | ||||
| Q_ASSERT(domain); | ||||
| if(orientation()==Qt::Horizontal){ | ||||
| q->setRange(QDateTime::fromMSecsSinceEpoch(domain->minX()), QDateTime::fromMSecsSinceEpoch(domain->maxX())); | ||||
| }else if(orientation()==Qt::Vertical){ | ||||
| q->setRange(QDateTime::fromMSecsSinceEpoch(domain->minY()), QDateTime::fromMSecsSinceEpoch(domain->maxY())); | ||||
| } | ||||
| } | ||||
| 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()); | ||||
| } | ||||
| ChartAxis* QDateTimeAxisPrivate::createGraphics(ChartPresenter* presenter) | ||||
| { | ||||
| Q_Q(QDateTimeAxis); | ||||
| if(m_orientation == Qt::Vertical){ | ||||
| return new ChartDateTimeAxisY(q,presenter); | ||||
| }else{ | ||||
| return new ChartDateTimeAxisX(q,presenter); | ||||
| } | ||||
| } | ||||
| void QDateTimeAxisPrivate::intializeDomain(Domain* domain) | ||||
| { | ||||
| Q_Q(QDateTimeAxis); | ||||
| if(m_max == m_min) { | ||||
| if(m_orientation==Qt::Vertical){ | ||||
| q->setRange(QDateTime::fromMSecsSinceEpoch(domain->minY()), QDateTime::fromMSecsSinceEpoch(domain->maxY())); | ||||
| }else{ | ||||
| q->setRange(QDateTime::fromMSecsSinceEpoch(domain->minX()), QDateTime::fromMSecsSinceEpoch(domain->maxX())); | ||||
| } | ||||
| } else { | ||||
| if(m_orientation==Qt::Vertical){ | ||||
| domain->setRangeY(m_min.toMSecsSinceEpoch(), m_max.toMSecsSinceEpoch()); | ||||
| }else{ | ||||
| domain->setRangeX(m_min.toMSecsSinceEpoch(), m_max.toMSecsSinceEpoch()); | ||||
| } | ||||
| } | ||||
| } | ||||
| #include "moc_qdatetimeaxis.cpp" | ||||
| #include "moc_qdatetimeaxis_p.cpp" | ||||
| QTCOMMERCIALCHART_END_NAMESPACE | ||||