/****************************************************************************

**

** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

** All rights reserved.

** Contact: Nokia Corporation (qt-info@nokia.com)

**

** This file is part of the QtGui module of the Qt Toolkit.

**

** $QT_BEGIN_LICENSE:LGPL$

** No Commercial Usage

** This file contains pre-release code and may not be distributed.

** You may use this file in accordance with the terms and conditions

** contained in the Technology Preview License Agreement accompanying

** this package.

**

** GNU Lesser General Public License Usage

** Alternatively, this file may be used under the terms of the GNU Lesser

** General Public License version 2.1 as published by the Free Software

** Foundation and appearing in the file LICENSE.LGPL included in the

** packaging of this file.  Please review the following information to

** ensure the GNU Lesser General Public License version 2.1 requirements

** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

**

** In addition, as a special exception, Nokia gives you certain additional

** rights.  These rights are described in the Nokia Qt LGPL Exception

** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

**

** If you have questions regarding the use of this file, please contact

** Nokia at qt-info@nokia.com.

**

**

**

**

**

**

**

**

** $QT_END_LICENSE$

**

****************************************************************************/

#include <math.h>

#include <private/qdatetimeedit_p.h>

#include <qabstractspinbox.h>

#include <qapplication.h>

#include <qdatetimeedit.h>

#include <qdesktopwidget.h>

#include <qdebug.h>

#include <qevent.h>

#include <qlineedit.h>

#include <private/qlineedit_p.h>

#include <qlocale.h>

#include <qpainter.h>

#include <qlayout.h>

#include <qset.h>

#include <qstyle.h>

#ifndef QT_NO_DATETIMEEDIT

//#define QDATETIMEEDIT_QDTEDEBUG

#ifdef QDATETIMEEDIT_QDTEDEBUG

#  define QDTEDEBUG qDebug() << QString::fromLatin1("%1:%2").arg(__FILE__).arg(__LINE__)

#  define QDTEDEBUGN qDebug

#else

#  define QDTEDEBUG if (false) qDebug()

#  define QDTEDEBUGN if (false) qDebug

#endif

QT_BEGIN_NAMESPACE

// --- QDateTimeEdit ---

/*!

  \class QDateTimeEdit

  \brief The QDateTimeEdit class provides a widget for editing dates and times.

  \ingroup basicwidgets

  QDateTimeEdit allows the user to edit dates by using the keyboard or

  the arrow keys to increase and decrease date and time values. The

  arrow keys can be used to move from section to section within the

  QDateTimeEdit box. Dates and times appear in accordance with the

  format set; see setDisplayFormat().

  \snippet doc/src/snippets/code/src_gui_widgets_qdatetimeedit.cpp 0

  Here we've created a new QDateTimeEdit object initialized with

  today's date, and restricted the valid date range to today plus or

  minus 365 days. We've set the order to month, day, year.

  The minimum value for QDateTimeEdit is 14 September 1752,

  and 2 January 4713BC for QDate. You can change this by calling

  setMinimumDate(), setMaximumDate(),  setMinimumTime(),

  and setMaximumTime().

  \section1 Using a Pop-up Calendar Widget

  QDateTimeEdit can be configured to allow a QCalendarWidget to be used

  to select dates. This is enabled by setting the calendarPopup property.

  Additionally, you can supply a custom calendar widget for use as the

  calendar pop-up by calling the setCalendarWidget() function. The existing

  calendar widget can be retrieved with calendarWidget().

  \table 100%

  \row \o \inlineimage windowsxp-datetimeedit.png Screenshot of a Windows XP style date time editing widget

       \o A date time editing widget shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}.

  \row \o \inlineimage macintosh-datetimeedit.png Screenshot of a Macintosh style date time editing widget

       \o A date time editing widget shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}.

  \row \o \inlineimage plastique-datetimeedit.png Screenshot of a Plastique style date time editing widget

       \o A date time editing widget shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}.

  \endtable

  \sa QDateEdit, QTimeEdit, QDate, QTime

*/

/*!

  \enum QDateTimeEdit::Section

  \value NoSection

  \value AmPmSection

  \value MSecSection

  \value SecondSection

  \value MinuteSection

  \value HourSection

  \value DaySection

  \value MonthSection

  \value YearSection

  \omitvalue DateSections_Mask

  \omitvalue TimeSections_Mask

*/

/*!

  \fn void QDateTimeEdit::dateTimeChanged(const QDateTime &datetime)

  This signal is emitted whenever the date or time is changed. The

  new date and time is passed in \a datetime.

*/

/*!

  \fn void QDateTimeEdit::timeChanged(const QTime &time)

  This signal is emitted whenever the time is changed. The new time

  is passed in \a time.

*/

/*!

  \fn void QDateTimeEdit::dateChanged(const QDate &date)

  This signal is emitted whenever the date is changed. The new date

  is passed in \a date.

*/

/*!

  Constructs an empty date time editor with a \a parent.

*/

QDateTimeEdit::QDateTimeEdit(QWidget *parent)

    : QAbstractSpinBox(*new QDateTimeEditPrivate, parent)

{

    Q_D(QDateTimeEdit);

    d->init(QDateTime(QDATETIMEEDIT_DATE_INITIAL, QDATETIMEEDIT_TIME_MIN));

}

/*!

  Constructs an empty date time editor with a \a parent. The value

  is set to \a datetime.

*/

QDateTimeEdit::QDateTimeEdit(const QDateTime &datetime, QWidget *parent)

    : QAbstractSpinBox(*new QDateTimeEditPrivate, parent)

{

    Q_D(QDateTimeEdit);

    d->init(datetime.isValid() ? datetime : QDateTime(QDATETIMEEDIT_DATE_INITIAL,

                                                      QDATETIMEEDIT_TIME_MIN));

}

/*!

  \fn QDateTimeEdit::QDateTimeEdit(const QDate &date, QWidget *parent)

  Constructs an empty date time editor with a \a parent.

  The value is set to \a date.

*/

QDateTimeEdit::QDateTimeEdit(const QDate &date, QWidget *parent)

    : QAbstractSpinBox(*new QDateTimeEditPrivate, parent)

{

    Q_D(QDateTimeEdit);

    d->init(date.isValid() ? date : QDATETIMEEDIT_DATE_INITIAL);

}

/*!

  \fn QDateTimeEdit::QDateTimeEdit(const QTime &time, QWidget *parent)

  Constructs an empty date time editor with a \a parent.

  The value is set to \a time.

*/

QDateTimeEdit::QDateTimeEdit(const QTime &time, QWidget *parent)

    : QAbstractSpinBox(*new QDateTimeEditPrivate, parent)

{

    Q_D(QDateTimeEdit);

    d->init(time.isValid() ? time : QDATETIMEEDIT_TIME_MIN);

}

/*!

  \internal

*/

QDateTimeEdit::QDateTimeEdit(const QVariant &var, QVariant::Type parserType, QWidget *parent)

    : QAbstractSpinBox(*new QDateTimeEditPrivate, parent)

{

    Q_D(QDateTimeEdit);

    d->parserType = parserType;

    d->init(var);

}

/*!

  \property QDateTimeEdit::dateTime

  \brief the QDateTime that is set in the QDateTimeEdit

  When setting this property the timespec of the QDateTimeEdit remains the same

  and the timespec of the new QDateTime is ignored.

  By default, this property contains a date that refers to January 1,

  2000 and a time of 00:00:00 and 0 milliseconds.

  \sa date, time

*/

QDateTime QDateTimeEdit::dateTime() const

{

    Q_D(const QDateTimeEdit);

    return d->value.toDateTime();

}

void QDateTimeEdit::setDateTime(const QDateTime &datetime)

{

    Q_D(QDateTimeEdit);

    if (datetime.isValid()) {

        d->clearCache();

        if (!(d->sections & DateSections_Mask))

            setDateRange(datetime.date(), datetime.date());

        d->setValue(QDateTime(datetime.date(), datetime.time(), d->spec), EmitIfChanged);

    }

}

/*!

  \property QDateTimeEdit::date

  \brief the QDate that is set in the QDateTimeEdit

  By default, this property contains a date that refers to January 1, 2000.

  \sa time, dateTime

*/

/*!

    Returns the date of the date time edit.

*/

QDate QDateTimeEdit::date() const

{

    Q_D(const QDateTimeEdit);

    return d->value.toDate();

}

void QDateTimeEdit::setDate(const QDate &date)

{

    Q_D(QDateTimeEdit);

    if (date.isValid()) {

        if (!(d->sections & DateSections_Mask))

            setDateRange(date, date);

        d->clearCache();

        d->setValue(QDateTime(date, d->value.toTime(), d->spec), EmitIfChanged);

        d->updateTimeSpec();

    }

}

/*!

  \property QDateTimeEdit::time

  \brief the QTime that is set in the QDateTimeEdit

  By default, this property contains a time of 00:00:00 and 0 milliseconds.

  \sa date, dateTime

*/

/*!

    Returns the time of the date time edit.

*/

QTime QDateTimeEdit::time() const

{

    Q_D(const QDateTimeEdit);

    return d->value.toTime();

}

void QDateTimeEdit::setTime(const QTime &time)

{

    Q_D(QDateTimeEdit);

    if (time.isValid()) {

        d->clearCache();

        d->setValue(QDateTime(d->value.toDate(), time, d->spec), EmitIfChanged);

    }

}

/*!

  \property QDateTimeEdit::minimumDateTime

  \since 4.4

  \brief the minimum datetime of the date time edit

  When setting this property the \l maximumDateTime() is adjusted if

  necessary to ensure that the range remains valid. If the datetime is

  not a valid QDateTime object, this function does nothing.

  The default minimumDateTime can be restored with

  clearMinimumDateTime()

  By default, this property contains a date that refers to September 14,

  1752 and a time of 00:00:00 and 0 milliseconds.

  \sa maximumDateTime(), minimumTime(), maximumTime(), minimumDate(),

  maximumDate(), setDateTimeRange(), setDateRange(), setTimeRange(),

  clearMaximumDateTime(), clearMinimumDate(),

  clearMaximumDate(), clearMinimumTime(), clearMaximumTime()

*/

QDateTime QDateTimeEdit::minimumDateTime() const

{

    Q_D(const QDateTimeEdit);

    return d->minimum.toDateTime();

}

void QDateTimeEdit::clearMinimumDateTime()

{

    setMinimumDateTime(QDateTime(QDATETIMEEDIT_COMPAT_DATE_MIN, QDATETIMEEDIT_TIME_MIN));

}

void QDateTimeEdit::setMinimumDateTime(const QDateTime &dt)

{

    Q_D(QDateTimeEdit);

    if (dt.isValid() && dt.date() >= QDATETIMEEDIT_DATE_MIN) {

        const QDateTime m = dt.toTimeSpec(d->spec);

        const QDateTime max = d->maximum.toDateTime();

        d->setRange(m, (max > m ? max : m));

    }

}

/*!

  \property QDateTimeEdit::maximumDateTime

  \since 4.4

  \brief the maximum datetime of the date time edit

  When setting this property the \l minimumDateTime() is adjusted if

  necessary to ensure that the range remains valid. If the datetime is

  not a valid QDateTime object, this function does nothing.

  The default maximumDateTime can be restored with

  clearMaximumDateTime().

  By default, this property contains a date that refers to 31 December,

  7999 and a time of 23:59:59 and 999 milliseconds.

  \sa minimumDateTime(), minimumTime(), maximumTime(), minimumDate(),

  maximumDate(), setDateTimeRange(), setDateRange(), setTimeRange(),

  clearMinimumDateTime(), clearMinimumDate(),

  clearMaximumDate(), clearMinimumTime(), clearMaximumTime()

*/

QDateTime QDateTimeEdit::maximumDateTime() const

{

    Q_D(const QDateTimeEdit);

    return d->maximum.toDateTime();

}

void QDateTimeEdit::clearMaximumDateTime()

{

    setMaximumDateTime(QDATETIMEEDIT_DATETIME_MAX);

}

void QDateTimeEdit::setMaximumDateTime(const QDateTime &dt)

{

    Q_D(QDateTimeEdit);

    if (dt.isValid() && dt.date() <= QDATETIMEEDIT_DATE_MAX) {

        const QDateTime m = dt.toTimeSpec(d->spec);

        const QDateTime min = d->minimum.toDateTime();

        d->setRange((min < m ? min : m), m);

    }

}

/*!

  Convenience function to set minimum and maximum date time with one

  function call.

  \since 4.4

  \snippet doc/src/snippets/code/src_gui_widgets_qdatetimeedit.cpp 1

  is analogous to:

  \snippet doc/src/snippets/code/src_gui_widgets_qdatetimeedit.cpp 2

  If either \a min or \a max are not valid, this function does

  nothing.

  \sa setMinimumDate(), maximumDate(), setMaximumDate(),

  clearMinimumDate(), setMinimumTime(), maximumTime(),

  setMaximumTime(), clearMinimumTime(), QDateTime::isValid()

*/

void QDateTimeEdit::setDateTimeRange(const QDateTime &min, const QDateTime &max)

{

    Q_D(QDateTimeEdit);

    const QDateTime minimum = min.toTimeSpec(d->spec);

    QDateTime maximum = max.toTimeSpec(d->spec);

    if (min > max)

        maximum = minimum;

    d->setRange(minimum, maximum);

}

/*!

  \property QDateTimeEdit::minimumDate

  \brief the minimum date of the date time edit

  When setting this property the \l maximumDate is adjusted if

  necessary, to ensure that the range remains valid. If the date is

  not a valid QDate object, this function does nothing.

  By default, this property contains a date that refers to September 14, 1752.

  The minimum date must be at least the first day in year 100, otherwise

  setMinimumDate() has no effect.

  \sa minimumTime(), maximumTime(), setDateRange()

*/

QDate QDateTimeEdit::minimumDate() const

{

    Q_D(const QDateTimeEdit);

    return d->minimum.toDate();

}

void QDateTimeEdit::setMinimumDate(const QDate &min)

{

    Q_D(QDateTimeEdit);

    if (min.isValid() && min >= QDATETIMEEDIT_DATE_MIN) {

        setMinimumDateTime(QDateTime(min, d->minimum.toTime(), d->spec));

    }

}

void QDateTimeEdit::clearMinimumDate()

{

    setMinimumDate(QDATETIMEEDIT_COMPAT_DATE_MIN);

}

/*!

  \property QDateTimeEdit::maximumDate

  \brief the maximum date of the date time edit

  When setting this property the \l minimumDate is adjusted if

  necessary to ensure that the range remains valid. If the date is

  not a valid QDate object, this function does nothing.

  By default, this property contains a date that refers to December 31, 7999.

  \sa minimumDate, minimumTime, maximumTime, setDateRange()

*/

QDate QDateTimeEdit::maximumDate() const

{

    Q_D(const QDateTimeEdit);

    return d->maximum.toDate();

}

void QDateTimeEdit::setMaximumDate(const QDate &max)

{

    Q_D(QDateTimeEdit);

    if (max.isValid()) {

        setMaximumDateTime(QDateTime(max, d->maximum.toTime(), d->spec));

    }

}

void QDateTimeEdit::clearMaximumDate()

{

    setMaximumDate(QDATETIMEEDIT_DATE_MAX);

}

/*!

  \property QDateTimeEdit::minimumTime

  \brief the minimum time of the date time edit

  When setting this property the \l maximumTime is adjusted if

  necessary, to ensure that the range remains valid. If the time is

  not a valid QTime object, this function does nothing.

  By default, this property contains a time of 00:00:00 and 0 milliseconds.

  \sa maximumTime, minimumDate, maximumDate, setTimeRange()

*/

QTime QDateTimeEdit::minimumTime() const

{

    Q_D(const QDateTimeEdit);

    return d->minimum.toTime();

}

void QDateTimeEdit::setMinimumTime(const QTime &min)

{

    Q_D(QDateTimeEdit);

    if (min.isValid()) {

        const QDateTime m(d->minimum.toDate(), min, d->spec);

        setMinimumDateTime(m);

    }

}

void QDateTimeEdit::clearMinimumTime()

{

    setMinimumTime(QDATETIMEEDIT_TIME_MIN);

}

/*!

  \property QDateTimeEdit::maximumTime