##// END OF EJS Templates
Updated min, max properties of values and datetime axes descriptions with information about maintaining the range validity
Updated min, max properties of values and datetime axes descriptions with information about maintaining the range validity

File last commit:

r1730:029fd1880e16
r1730:029fd1880e16
Show More
qdatetimeaxis.cpp
332 lines | 8.2 KiB | text/x-c | CppLexer
/****************************************************************************
**
** 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
ValuesAxis can be setup to show axis line with tick marks, grid lines and shades.
Values of axis are drawn to position of ticks
*/
/*!
\qmlclass ValuesAxis QDateTimeAxis
\brief The ValuesAxis 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
To access Axes you can use ChartView API. For example:
\code
ChartView {
ValuesAxis {
id: xAxis
min: 0
max: 10
}
// Add a few series...
}
\endcode
*/
/*!
\property QDateTimeAxis::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 ValuesAxis::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 QDateTimeAxis::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 ValuesAxis::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.
*/
/*!
\fn void QDateTimeAxis::minChanged(qreal min)
Axis emits signal when \a min of axis has changed.
*/
/*!
\qmlsignal ValuesAxis::onMinChanged(real min)
Axis emits signal when \a min of axis has changed.
*/
/*!
\fn void QDateTimeAxis::maxChanged(qreal max)
Axis emits signal when \a max of axis has changed.
*/
/*!
\qmlsignal ValuesAxis::onMaxChanged(real max)
Axis emits signal when \a max of axis has changed.
*/
/*!
\fn void QDateTimeAxis::rangeChanged(qreal min, qreal max)
Axis emits signal when \a min or \a max of axis has changed.
*/
/*!
\property QDateTimeAxis::ticksCount
The number of tick marks for the axis.
*/
/*!
\qmlproperty int ValuesAxis::ticksCount
The number of tick marks for the axis.
*/
/*!
\property QDateTimeAxis::niceNumbersEnabled
Whether the nice numbers algorithm is enabled or not for the axis.
*/
/*!
\qmlproperty bool ValuesAxis::niceNumbersEnabled
Whether the nice numbers algorithm is enabled or not 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);
if (min.isValid())
setRange(min, qMax(d->m_max, min));
}
QDateTime QDateTimeAxis::min() const
{
Q_D(const QDateTimeAxis);
return d->m_min;
}
void QDateTimeAxis::setMax(QDateTime max)
{
Q_D(QDateTimeAxis);
if (max.isValid())
setRange(qMin(d->m_min, max), max);
}
QDateTime QDateTimeAxis::max() const
{
Q_D(const QDateTimeAxis);
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 QDateTimeAxis::setRange(QDateTime min, QDateTime max)
{
Q_D(QDateTimeAxis);
if (!min.isValid() || !max.isValid() || min > max)
return;
bool changed = false;
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(d->m_niceNumbers) d->looseNiceNumbers(d->m_min, d->m_max, d->m_tickCount);
if (changed) {
emit rangeChanged(d->m_min,d->m_max);
d->emitUpdated();
}
}
void QDateTimeAxis::setFormatString(QString format)
{
Q_D(QDateTimeAxis);
d->m_format = format;
}
QString QDateTimeAxis::formatString() const
{
Q_D(const QDateTimeAxis);
return d->m_format;
}
/*!
Sets \a count for ticks on the axis.
*/
void QDateTimeAxis::setTicksCount(int count)
{
Q_D(QDateTimeAxis);
if (d->m_tickCount != count && count >=2) {
d->m_tickCount = count;
d->emitUpdated();
}
}
/*!
\fn int QDateTimeAxis::ticksCount() const
Return number of ticks on the axis
*/
int QDateTimeAxis::ticksCount() const
{
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),
m_tickCount(5)
{
m_min = QDateTime::fromMSecsSinceEpoch(0);
m_max = QDateTime::fromMSecsSinceEpoch(0);
m_format = "hh:mm:ss\ndd-mm-yyyy";
}
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