##// END OF EJS Templates
HG_REPOSITORIES » LPP » INSTRUMENTATION » USERS » JEANDET » qtcharts
RSS

Clone from http://code.qt.io/qt/qtcharts.git

Fancified the demos page of docs
Fancified the demos page of docs
Tero Ahola - - Load All Authors

File last commit:

r2027:32de3be17db8
r2037:f208001aad1c
Show More
qdatetimeaxis.cpp
366 lines | 9.7 KiB | text/x-c | CppLexer
/ src / axis / datetimeaxis / qdatetimeaxis.cpp
History | Source | Raw |Copy content |Copy permalink
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>
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
QDateTimeAxis: precise range specified in Docs
 r1927 QDateTimeAxis works correctly with dates from 4714 BCE to 287396 CE
Marek Rosa
QDateTimeAxis docs updated
 r1984 There are also other limitiation related to QDateTime . Please refer to QDateTime documentation.
Marek Rosa
DateTimeAxis formatString -> format
 r1801 QDateTimeAxis can be setup to show axis line with tick marks, grid lines and shades.
Marek Rosa
QDateTimeAxis: added snippet on how to use it
 r1882
Marek Rosa
QDateTimeAxis docs updated
 r1984 NOTE: QDateTimeAxis is disabled on ARM platform at the present time.
Marek Rosa
Axis docs updated
 r1887 \image api_datatime_axis.png
Marek Rosa
QDateTimeAxis docs updated
 r1984 QDateTimeAxis can be used with QLineSeries, QSplineSeries or QScatterSeries.
To add a data point to the series QDateTime::toMSecsSinceEpoch() is used.
Marek Rosa
QDateTimeAxis: added snippet on how to use it
 r1882 \code
QLineSeries *series = new QLineSeries;
QDateTime xValue;
xValue.setDate(QDate(2012, 1 , 18));
xValue.setTime(QTime(9, 34));
Marek Rosa
QDateTimeAxis docs updated
 r1984 qreal yValue = 12;
series->append(xValue.toMSecsSinceEpoch(), yValue);
Marek Rosa
QDateTimeAxis: added snippet on how to use it
 r1882
xValue.setDate(QDate(2013, 5 , 11));
xValue.setTime(QTime(11, 14));
Marek Rosa
QDateTimeAxis docs updated
 r1984 qreal yValue = 22;
series->append(xValue.toMSecsSinceEpoch(), yValue);
\endcode
Adding the series to the chart and setting up the QDateTimeAxis.
\code
QChartView *chartView = new QChartView;
Marek Rosa
QDateTimeAxis: added snippet on how to use it
 r1882 chartView->chart()->addSeries(series);
// ...
QDateTimeAxis *axisX = new QDateTimeAxis;
axisX->setFormat("dd-MM-yyyy h:mm");
chartView->chart()->setAxisX(series, axisX);
\endcode
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
Tero Ahola
Property for QDateTimeAxis::format and a QML demo for axes
 r2027 \inherits AbstractAxis
Marek Rosa
DateTimeAxis formatString -> format
 r1801
The labels can be configured by setting an appropriate DateTime format.
Marek Rosa
Some axes docs update
 r1834 Note that any date before 4714 BCE or after about 1.4 million CE may not be accurately stored.
Marek Rosa
DateTimeAxis formatString -> format
 r1801 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.
*/
/*!
Tero Ahola
Property for QDateTimeAxis::format and a QML demo for axes
 r2027 \qmlproperty int DateTimeAxis::tickCount
Marek Rosa
Added QDateTimeAxis
 r1717 The number of tick marks for the axis.
*/
Tero Ahola
Property for QDateTimeAxis::format and a QML demo for axes
 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.
*/
/*!
\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.
*/
/*!
\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
Added QDateTimeAxis
 r1717 /*!
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 (changed) {
emit rangeChanged(d->m_min,d->m_max);
d->emitUpdated();
}
}
Marek Rosa
DateTimeAxis formatString -> format
 r1801 void QDateTimeAxis::setFormat(QString format)
Marek Rosa
Added QDateTimeAxis
 r1717 {
Q_D(QDateTimeAxis);
Tero Ahola
Property for QDateTimeAxis::format and a QML demo for axes
 r2027 if (d->m_format != format) {
d->m_format = format;
emit formatChanged(format);
}
Marek Rosa
Added QDateTimeAxis
 r1717 }
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),
Jani Honkonen
Fix some more Cppcheck findings
 r1921 m_min(QDateTime::fromMSecsSinceEpoch(0)),
m_max(QDateTime::fromMSecsSinceEpoch(0)),
Marek Rosa
Added QDateTimeAxis
 r1717 m_tickCount(5)
{
Marek Rosa
Axis docs updated
 r1887 m_format = "dd-MM-yyyy\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