##// END OF EJS Templates
Docs update after classes renaming
Docs update after classes renaming

File last commit:

r1812:329e3a076da0
r1812:329e3a076da0
Show More
qdatetimeaxis.cpp
322 lines | 8.3 KiB | text/x-c | CppLexer
Marek Rosa
Added QDateTimeAxis
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
DateTimeAxis formatString -> format
r1801 The labels can be configured by setting an appropriate DateTime format.
Marek Rosa
Enabled more tests in qdatetimeaxis
r1737 Note that any date before 4800 BCE or after about 1.4 million CE may not be accurately stored.
Marek Rosa
DateTimeAxis formatString -> format
r1801 QDateTimeAxis can be setup to show axis line with tick marks, grid lines and shades.
Marek Rosa
Added QDateTimeAxis
r1717 */
/*!
Marek Rosa
DateTimeAxis formatString -> format
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.
Note that any date before 4800 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
Added QDateTimeAxis
r1717 */
/*!
\property QDateTimeAxis::min
Defines the minimum value on the axis.
Marek Rosa
Updated min, max properties of values and datetime axes descriptions with information about maintaining the range validity
r1730 When setting this property the max is adjusted if necessary, to ensure that the range remains valid.
Marek Rosa
Added QDateTimeAxis
r1717 */
/*!
\qmlproperty real ValuesAxis::min
Defines the minimum value on the axis.
Marek Rosa
Updated min, max properties of values and datetime axes descriptions with information about maintaining the range validity
r1730 When setting this property the max is adjusted if necessary, to ensure that the range remains valid.
Marek Rosa
Added QDateTimeAxis
r1717 */
/*!
\property QDateTimeAxis::max
Defines the maximum value on the axis.
Marek Rosa
Updated min, max properties of values and datetime axes descriptions with information about maintaining the range validity
r1730 When setting this property the min is adjusted if necessary, to ensure that the range remains valid.
Marek Rosa
Added QDateTimeAxis
r1717 */
/*!
\qmlproperty real ValuesAxis::max
Defines the maximum value on the axis.
Marek Rosa
Updated min, max properties of values and datetime axes descriptions with information about maintaining the range validity
r1730 When setting this property the min is adjusted if necessary, to ensure that the range remains valid.
Marek Rosa
Added QDateTimeAxis
r1717 */
/*!
Marek Rosa
Docs update
r1731 \fn void QDateTimeAxis::minChanged(QDateTime min)
Marek Rosa
Added QDateTimeAxis
r1717 Axis emits signal when \a min of axis has changed.
*/
/*!
Marek Rosa
Docs update
r1731 \qmlsignal ValuesAxis::onMinChanged(QDateTime min)
Marek Rosa
Added QDateTimeAxis
r1717 Axis emits signal when \a min of axis has changed.
*/
/*!
Marek Rosa
Docs update
r1731 \fn void QDateTimeAxis::maxChanged(QDateTime max)
Marek Rosa
Added QDateTimeAxis
r1717 Axis emits signal when \a max of axis has changed.
*/
/*!
Marek Rosa
Docs update
r1731 \qmlsignal ValuesAxis::onMaxChanged(QDateTime max)
Marek Rosa
Added QDateTimeAxis
r1717 Axis emits signal when \a max of axis has changed.
*/
/*!
Marek Rosa
Docs update
r1731 \fn void QDateTimeAxis::rangeChanged(QDateTime min, QDateTime max)
Marek Rosa
Added QDateTimeAxis
r1717 Axis emits signal when \a min or \a max of axis has changed.
*/
/*!
Marek Rosa
Docs update after classes renaming
r1812 \property QDateTimeAxis::tickCount
Marek Rosa
Added QDateTimeAxis
r1717 The number of tick marks for the axis.
*/
/*!
Marek Rosa
Docs update after classes renaming
r1812 \qmlproperty int ValuesAxis::tickCount
Marek Rosa
Added QDateTimeAxis
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
Ranges on values, intervals and datatime axes cannot be set to be invalid
r1728 if (min.isValid())
setRange(min, qMax(d->m_max, min));
Marek Rosa
Added QDateTimeAxis
r1717 }
QDateTime QDateTimeAxis::min() const
{
Q_D(const QDateTimeAxis);
return d->m_min;
}
void QDateTimeAxis::setMax(QDateTime max)
{
Q_D(QDateTimeAxis);
Marek Rosa
Ranges on values, intervals and datatime axes cannot be set to be invalid
r1728 if (max.isValid())
setRange(qMin(d->m_min, max), max);
Marek Rosa
Added QDateTimeAxis
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
Updated min, max properties of values and datetime axes descriptions with information about maintaining the range validity
r1730 If min is greater than max then this function returns without making any changes.
Marek Rosa
Added QDateTimeAxis
r1717 */
void QDateTimeAxis::setRange(QDateTime min, QDateTime max)
{
Q_D(QDateTimeAxis);
Marek Rosa
Ranges on values, intervals and datatime axes cannot be set to be invalid
r1728 if (!min.isValid() || !max.isValid() || min > max)
return;
Marek Rosa
Added QDateTimeAxis
r1717
Marek Rosa
Ranges on values, intervals and datatime axes cannot be set to be invalid
r1728 bool changed = false;
Marek Rosa
Added QDateTimeAxis
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(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();
}
}
Marek Rosa
Docs update
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
Docs update after classes renaming
r1812 \sa format()
Marek Rosa
Docs update
r1731 */
Marek Rosa
DateTimeAxis formatString -> format
r1801 void QDateTimeAxis::setFormat(QString format)
Marek Rosa
Added QDateTimeAxis
r1717 {
Q_D(QDateTimeAxis);
d->m_format = format;
}
Marek Rosa
Docs update
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
Docs update after classes renaming
r1812 \sa setFormat()
Marek Rosa
Docs update
r1731 */
Marek Rosa
DateTimeAxis formatString -> format
r1801 QString QDateTimeAxis::format() const
Marek Rosa
Added QDateTimeAxis
r1717 {
Q_D(const QDateTimeAxis);
return d->m_format;
}
/*!
Sets \a count for ticks on the axis.
*/
Marek Rosa
DateTimeAxis formatString -> format
r1801 void QDateTimeAxis::setTickCount(int count)
Marek Rosa
Added QDateTimeAxis
r1717 {
Q_D(QDateTimeAxis);
if (d->m_tickCount != count && count >=2) {
d->m_tickCount = count;
d->emitUpdated();
}
}
/*!
Marek Rosa
Docs update after classes renaming
r1812 \fn int QDateTimeAxis::tickCount() const
Marek Rosa
Added QDateTimeAxis
r1717 Return number of ticks on the axis
*/
Marek Rosa
DateTimeAxis formatString -> format
r1801 int QDateTimeAxis::tickCount() const
Marek Rosa
Added QDateTimeAxis
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),
m_tickCount(5)
{
m_min = QDateTime::fromMSecsSinceEpoch(0);
m_max = QDateTime::fromMSecsSinceEpoch(0);
Marek Rosa
Added DateTimeAxis Example
r1739 m_format = "dd-MMM-yy\nh:mm";
Marek Rosa
Added QDateTimeAxis
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