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

**

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

** All rights reserved.

** Contact: Nokia Corporation (developer.feedback@nokia.com)

**

** This file is part of the HbWidgets module of the UI Extensions for Mobile.

**

** GNU Lesser General Public License Usage

** 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 developer.feedback@nokia.com.

**

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

#include "hbdatetimepicker_p.h"

#include "hbdatetimepicker.h"

#include "hbstyleoption_p.h"

/*!

    @beta

    \class HbDateTimePicker

    By default date picker will be created, with date functionality only.

    For exclusive time or datetime picker creation, use QTime or QDateTime variable as parameter for the constructor.

    \li Date and Time

    \li Date

    \li Time

    \snippet{ultimatecodesnippet/ultimatecodesnippet.cpp,51}

    \sa setDateRange \sa setTimeRange \sa setDateTimeRange

    \sa setMinimumTime \sa setMaximumTime \sa setMinimumDate \sa setMaximumDate

    \sa setMinimumDateTime \sa setMaximumDateTime

*/

/*!

    \fn void dateChanged(const QDate &date)

    \param date  selected by the user.

*/

/*!

    \fn void timeChanged(const QTime &time)

    \param time  selected by the user.

*/

/*!

    \fn void dateTimeChanged(const QDateTime &datetime)

    \param datetime  selected by the user.

*/

/*!

    Constructs date picker widget by default.

*/

HbDateTimePicker::HbDateTimePicker( QGraphicsItem *parent ):

HbWidget(*new HbDateTimePickerPrivate, parent)

{

}

/*!

*/

HbDateTimePicker::HbDateTimePicker(const QDateTime &datetime, QGraphicsItem *parent ):

HbWidget(*new HbDateTimePickerPrivate, parent)

{

    Q_D(HbDateTimePicker);

}

/*!

    \param date QDate value.

*/

HbDateTimePicker::HbDateTimePicker(const QDate &date, QGraphicsItem *parent ):

HbWidget(*new HbDateTimePickerPrivate, parent)

{

    Q_D(HbDateTimePicker);

    setDate(date);

}

/*!

    \param time QTime value.

*/

HbDateTimePicker::HbDateTimePicker(const QTime &time, QGraphicsItem *pParent ):

HbWidget(*new HbDateTimePickerPrivate, pParent)

{

    Q_D(HbDateTimePicker);

    setTime(time);

}

/*!

    the default mode is DateTimeMode, if other mode is required, set the mDateTimeMode variable.

    this does not set any default datetime, needs to be explicitly done in the derived constructor.

    \sa setDateTime, setTime, setDate

*/

HbDateTimePicker::HbDateTimePicker(HbDateTimePickerPrivate &dd, QGraphicsItem *parent):

HbWidget(dd, parent)

{

    Q_D(HbDateTimePicker);

}

/*!

    \reimp

*/

bool HbDateTimePicker::event(QEvent *e)

{    

    bool result = HbWidget::event(e);

    if (e->type()==QEvent::LayoutRequest) {

        updatePrimitives();

    }

    return result;

}

/*!

    Destructor.

*/

HbDateTimePicker::~HbDateTimePicker()

{

}

/*!

    Returns current display format as QString value.

    \sa setDisplayFormat()

 */

QString HbDateTimePicker::displayFormat() const

{

    Q_D(const HbDateTimePicker);

    return d->mFormat;

}

/*!

    Sets the display \a format . eg: DDMMYY, MMDDYY

    These expressions may be used for the format:

    <TABLE>

    <TR><TD><b><i> Expression </TD><TD> Output </TD></i></b></TR>

    <TR><TD> d </TD><TD><i> The day as a number without a leading zero (1 to 31)</i></TD></TR>

    <TR><TD> dd </TD><TD><i> The day as a number with a leading zero (01 to 31) </i></TD></TR>

    <TR><TD> ddd </TD><TD><i>

          The abbreviated localized day name (e.g. 'Mon' to 'Sun').

            Uses QDate::shortDayName().</i></TD></TR>

    <TR><TD> dddd </TD><TD><i>

          The long localized day name (e.g. 'Monday' to 'Sunday').

            Uses QDate::longDayName().</i></TD></TR>

    <TR><TD> M </TD><TD><i> The month as a number without a leading zero (1 to 12)</i></TD></TR>

    <TR><TD> MM </TD><TD><i> The month as a number with a leading zero (01 to 12)</i></TD></TR>

    <TR><TD> MMM </TD><TD><i>

         The abbreviated localized month name (e.g. 'Jan' to 'Dec').

            Uses QDate::shortMonthName().</i></TD></TR>

    <TR><TD> MMMM </TD><TD><i>

          The long localized month name (e.g. 'January' to 'December').

            Uses QDate::longMonthName().</i></TD></TR>

    <TR><TD> yy </TD><TD><i> The year as two digit number (00 to 99)</i></TD></TR>

    <TR><TD> yyyy </TD><TD><i> The year as four digit number. If the year is negative,

            a minus sign is prepended in addition.</i></TD></TR>

    </TABLE>

    NOTE:setDisplayFormat works only when the seperators are mentioned in the format like 'dd.mm.yy' or 'dd mm yy', this

         will be fixed in the future versions.

    \sa displayFormat()

*/

void HbDateTimePicker::setDisplayFormat(const QString &format)

{

        d->emitDateTimeChange();

}

/*!

    Returns the current date in QDate format.

    \sa setDate

*/

QDate HbDateTimePicker::date() const

{

    Q_D(const HbDateTimePicker);

    return d->mDateTime.date();

}

/*!

    Sets the current \a date in the form of QDate.

    \sa date

*/

void HbDateTimePicker::setDate(const QDate& date)

{

    Q_D(HbDateTimePicker);

    setDateTime(QDateTime(date,d->mDateTime.time()));

}

/*!

    Returns minimum date in QDate format.

    \sa setMinimumDate

*/

QDate HbDateTimePicker::minimumDate()const

{

    Q_D(const HbDateTimePicker);

    return d->mMinimumDate.date();

}

/*!

    Sets minimum \a date in QDate format.

    \sa minimumDate

*/

void HbDateTimePicker::setMinimumDate(const QDate& date)

{

    Q_D(HbDateTimePicker);

    setMinimumDateTime(QDateTime(date, d->mMinimumDate.time()));

}

/*!

    Returns maximum date in QDate format.

    \sa setMaximumDate

*/

QDate HbDateTimePicker::maximumDate()const

{

    Q_D(const HbDateTimePicker);

    return d->mMaximumDate.date();

}

/*!

    Sets maximum \a date in QDate format.

    \sa maximumDate

*/

void HbDateTimePicker::setMaximumDate(const QDate& date)

{

    Q_D(HbDateTimePicker);

    setMaximumDateTime(QDateTime(date, d->mMaximumDate.time()));

}

/*!

    \param minDate Minimum date in QDate format.

    \param maxDate Maximum date in QDate format.

    \sa setMinimumDate \sa setMaximumDate

*/

void HbDateTimePicker::setDateRange(const QDate &minDate, const QDate &maxDate)

{

    Q_D(HbDateTimePicker);

    setDateTimeRange(QDateTime(minDate, d->mMinimumDate.time()),

                         QDateTime(maxDate, d->mMaximumDate.time()));

}

/*!

    \return date and time value in QDateTime format.

    \sa setDateTime

*/

QDateTime HbDateTimePicker::dateTime()const

{

    Q_D(const HbDateTimePicker);

    return d->mDateTime;

}

/*!

    \param datetime in QDateTime format.

    \sa dateTime

*/

void HbDateTimePicker::setDateTime(const QDateTime &datetime)

{

    Q_D(HbDateTimePicker);

    d->setDateTime(datetime);

}

/*!

    \return Minimum date and minimum time in QDateTime format.

    \sa setMinimumDateTime

*/

QDateTime HbDateTimePicker::minimumDateTime()const

{

    Q_D(const HbDateTimePicker);

    return d->mMinimumDate;

}

/*!

    \param datetime minimum date and minimum time in QDateTime format.

    \sa minimumDateTime \sa setMinimumDate \sa setMinimumTime

*/

void HbDateTimePicker::setMinimumDateTime(const QDateTime& datetime)

{

    Q_D(HbDateTimePicker);

    d->setMinimumDateTime(datetime);

}

/*!

    \return Maximum date and maximum time in QDateTime format.

*/

QDateTime HbDateTimePicker::maximumDateTime()const

{

    Q_D(const HbDateTimePicker);

    return d->mMaximumDate;

}

/*!

    \param date Maximum date and maximum time in QDateTime format.

    \sa maximumDateTime \sa setMaximumDate \sa setMaximumTime

*/

void HbDateTimePicker::setMaximumDateTime(const QDateTime& date)

{

    Q_D(HbDateTimePicker);

    d->setMaximumDateTime(date);

}

/*!

    \param minDateTime minimum date and time in QDateTime format.

    \param maxDateTime maximum date and time in QDateTime format.