diff options
Diffstat (limited to 'src/qt3support/widgets/q3datetimeedit.cpp')
| -rw-r--r-- | src/qt3support/widgets/q3datetimeedit.cpp | 2826 |
1 files changed, 2826 insertions, 0 deletions
diff --git a/src/qt3support/widgets/q3datetimeedit.cpp b/src/qt3support/widgets/q3datetimeedit.cpp new file mode 100644 index 0000000..3d02687 --- /dev/null +++ b/src/qt3support/widgets/q3datetimeedit.cpp @@ -0,0 +1,2826 @@ +/**************************************************************************** +** +** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). +** Contact: Qt Software Information (qt-info@nokia.com) +** +** This file is part of the Qt3Support 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 either Technology Preview License Agreement or the +** Beta Release License Agreement. +** +** 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.0, included in the file LGPL_EXCEPTION.txt in this +** package. +** +** GNU General Public License Usage +** Alternatively, this file may be used under the terms of the GNU +** General Public License version 3.0 as published by the Free Software +** Foundation and appearing in the file LICENSE.GPL included in the +** packaging of this file. Please review the following information to +** ensure the GNU General Public License version 3.0 requirements will be +** met: http://www.gnu.org/copyleft/gpl.html. +** +** If you are unsure which license is appropriate for your use, please +** contact the sales department at qt-sales@nokia.com. +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#include "q3datetimeedit.h" + +#ifndef QT_NO_DATETIMEEDIT + +#include <private/q3richtext_p.h> +#include "qevent.h" +#include "q3rangecontrol.h" +#include "qapplication.h" +#include "qpixmap.h" +#include "qlist.h" +#include "qstring.h" +#include "qstyle.h" + +#if defined(Q_WS_WIN) +#include "qt_windows.h" +#endif + +QT_BEGIN_NAMESPACE + +#define QDATETIMEEDIT_HIDDEN_CHAR QLatin1Char('0') + +class Q_COMPAT_EXPORT QNumberSection +{ +public: + QNumberSection(int selStart = 0, int selEnd = 0, bool separat = true, int actual = -1) + : selstart(selStart), selend(selEnd), act(actual), sep(separat) + {} + int selectionStart() const { return selstart; } + void setSelectionStart(int s) { selstart = s; } + int selectionEnd() const { return selend; } + void setSelectionEnd(int s) { selend = s; } + int width() const { return selend - selstart; } + int index() const { return act; } + bool separator() const { return sep; } + Q_DUMMY_COMPARISON_OPERATOR(QNumberSection) +private: + signed int selstart :12; + signed int selend :12; + signed int act :7; + bool sep :1; +}; + +static QString *lDateSep = 0; +static QString *lTimeSep = 0; +static bool lAMPM = false; +static QString *lAM = 0; +static QString *lPM = 0; +static Q3DateEdit::Order lOrder = Q3DateEdit::YMD; +static int refcount = 0; + +static void cleanup() +{ + delete lDateSep; + lDateSep = 0; + delete lTimeSep; + lTimeSep = 0; + delete lAM; + lAM = 0; + delete lPM; + lPM = 0; +} + +/*! +\internal +try to get the order of DMY and the date/time separator from the locale settings +*/ +static void readLocaleSettings() +{ + int dpos, mpos, ypos; + cleanup(); + + lDateSep = new QString(); + lTimeSep = new QString(); + +#if defined(Q_WS_WIN) + QT_WA({ + TCHAR data[10]; + GetLocaleInfo(LOCALE_USER_DEFAULT, LOCALE_SDATE, data, 10); + *lDateSep = QString::fromUtf16((ushort*)data); + GetLocaleInfo(LOCALE_USER_DEFAULT, LOCALE_STIME, data, 10); + *lTimeSep = QString::fromUtf16((ushort*)data); + GetLocaleInfo(LOCALE_USER_DEFAULT, LOCALE_ITIME, data, 10); + lAMPM = QString::fromUtf16((ushort*)data).toInt()==0; + GetLocaleInfo(LOCALE_USER_DEFAULT, LOCALE_S1159, data, 10); + QString am = QString::fromUtf16((ushort*)data); + if (!am.isEmpty()) + lAM = new QString(am); + GetLocaleInfo(LOCALE_USER_DEFAULT, LOCALE_S2359, data, 10); + QString pm = QString::fromUtf16((ushort*)data); + if (!pm.isEmpty() ) + lPM = new QString(pm); + } , { + char data[10]; + GetLocaleInfoA(LOCALE_USER_DEFAULT, LOCALE_SDATE, (char*)&data, 10); + *lDateSep = QString::fromLocal8Bit(data); + GetLocaleInfoA(LOCALE_USER_DEFAULT, LOCALE_STIME, (char*)&data, 10); + *lTimeSep = QString::fromLocal8Bit(data); + GetLocaleInfoA(LOCALE_USER_DEFAULT, LOCALE_ITIME, (char*)&data, 10); + lAMPM = QString::fromLocal8Bit(data).toInt()==0; + GetLocaleInfoA(LOCALE_USER_DEFAULT, LOCALE_S1159, (char*)&data, 10); + QString am = QString::fromLocal8Bit(data); + if (!am.isEmpty()) + lAM = new QString(am); + GetLocaleInfoA(LOCALE_USER_DEFAULT, LOCALE_S2359, (char*)&data, 10); + QString pm = QString::fromLocal8Bit(data); + if (!pm.isEmpty()) + lPM = new QString(pm); + }); +#else + *lDateSep = QLatin1Char('-'); + *lTimeSep = QLatin1Char(':'); +#endif + QString d = QDate(1999, 11, 22).toString(Qt::LocalDate); + dpos = d.indexOf(QLatin1String("22")); + mpos = d.indexOf(QLatin1String("11")); + ypos = d.indexOf(QLatin1String("99")); + if (dpos > -1 && mpos > -1 && ypos > -1) { + // test for DMY, MDY, YMD, YDM + if (dpos < mpos && mpos < ypos) { + lOrder = Q3DateEdit::DMY; + } else if (mpos < dpos && dpos < ypos) { + lOrder = Q3DateEdit::MDY; + } else if (ypos < mpos && mpos < dpos) { + lOrder = Q3DateEdit::YMD; + } else if (ypos < dpos && dpos < mpos) { + lOrder = Q3DateEdit::YDM; + } else { + // cannot determine the dateformat - use the default + return; + } + + // this code needs to change if new formats are added + +#ifndef Q_WS_WIN + QString sep = d.mid(qMin(dpos, mpos) + 2, QABS(dpos - mpos) - 2); + if (d.count(sep) == 2) { + *lDateSep = sep; + } +#endif + } + +#ifndef Q_WS_WIN + QString t = QTime(11, 22, 33).toString(Qt::LocalDate); + dpos = t.indexOf(QLatin1String("11")); + mpos = t.indexOf(QLatin1String("22")); + ypos = t.indexOf(QLatin1String("33")); + // We only allow hhmmss + if (dpos > -1 && dpos < mpos && mpos < ypos) { + QString sep = t.mid(dpos + 2, mpos - dpos - 2); + if (sep == t.mid(mpos + 2, ypos - mpos - 2)) { + *lTimeSep = sep; + } + } +#endif +} + +static Q3DateEdit::Order localOrder() { + if (!lDateSep) { + readLocaleSettings(); + } + return lOrder; +} + +static QString localDateSep() { + if (!lDateSep) { + readLocaleSettings(); + } + return *lDateSep; +} + +static QString localTimeSep() { + if (!lTimeSep) { + readLocaleSettings(); + } + return *lTimeSep; +} + +class Q3DateTimeEditorPrivate +{ +public: + Q3DateTimeEditorPrivate() + : frm(true), + parag(new Q3TextParagraph(0, 0, 0, false)), + focusSec(0) + { + parag->formatter()->setWrapEnabled(false); + cursor = new Q3TextCursor(0); + cursor->setParagraph(parag); + offset = 0; + sep = localDateSep(); + refcount++; + } + ~Q3DateTimeEditorPrivate() + { + delete parag; + delete cursor; + if (!--refcount) + cleanup(); + } + + void appendSection(const QNumberSection& sec) + { + sections.append(sec); + + } + void clearSections() + { + sections.clear(); + } + void setSectionSelection(int sec, int selstart, int selend) + { + if (sec < 0 || sec >= sections.count()) + return; + sections[sec].setSelectionStart(selstart); + sections[sec].setSelectionEnd(selend); + } + uint sectionCount() const { return (uint)sections.count(); } + void setSeparator(const QString& s) { sep = s; } + QString separator() const { return sep; } + + void setFrame(bool f) { frm = f; } + bool frame() const { return frm; } + + int focusSection() const { return focusSec; } + int section(const QPoint& p) + { + cursor->place(p + QPoint(offset, 0), parag); + int idx = cursor->index(); + for (int i = 0; i < sections.count(); ++i) { + if (idx >= sections[i].selectionStart() && + idx <= sections[i].selectionEnd()) + return i; + } + return -1; + } + QNumberSection section(int idx) const + { + return sections[idx]; + } + bool setFocusSection(int idx) + { + if (idx > (int)sections.count()-1 || idx < 0) + return false; + if (idx != focusSec) { + focusSec = idx; + applyFocusSelection(); + return true; + } + return false; + } + + bool inSectionSelection(int idx) + { + for (int i = 0; i < sections.count(); ++i) { + if (idx >= sections[i].selectionStart() && + idx <= sections[i].selectionEnd()) + return true; + } + return false; + } + + void paint(const QString& txt, bool focus, QPainter& p, + const QPalette&pal, const QRect& rect, QStyle *style) + { + int fw = 0; + if (frm) + fw = style->pixelMetric(QStyle::PM_DefaultFrameWidth); + + parag->truncate(0); + parag->append(txt); + if (!focus) + parag->removeSelection(Q3TextDocument::Standard); + else { + applyFocusSelection(); + } + + /* color all QDATETIMEEDIT_HIDDEN_CHAR chars to background color */ + Q3TextFormat *fb = parag->formatCollection()->format(p.font(), + pal.base().color()); + Q3TextFormat *nf = parag->formatCollection()->format(p.font(), + pal.text().color()); + for (int i = 0; i < txt.length(); ++i) { + parag->setFormat(i, 1, nf); + if (inSectionSelection(i)) + continue; + if (txt.at(i) == QDATETIMEEDIT_HIDDEN_CHAR) + parag->setFormat(i, 1, fb); + else + parag->setFormat(i, 1, nf); + } + fb->removeRef(); + nf->removeRef(); + + QRect r(rect.x(), rect.y(), rect.width() - 2 * (2 + fw), rect.height()); + parag->pseudoDocument()->docRect = r; + parag->invalidate(0); + parag->format(); + + int xoff = 2 + fw - offset; + int yoff = (rect.height() - parag->rect().height() + 1) / 2; + if (yoff < 0) + yoff = 0; + + p.translate(xoff, yoff); + parag->paint(p, pal, 0, true); + if (frm) + p.translate(-xoff, -yoff); + } + + void resize(const QSize& size) { sz = size; } + + int mapSection(int sec) + { + return (sec >= 0 && sec < sections.count() ? sections[sec].index() : -1); + } + +protected: + void applyFocusSelection() + { + if (focusSec > -1 && focusSec < sections.count()) { + int selstart = sections[focusSec].selectionStart(); + int selend = sections[focusSec].selectionEnd(); + parag->setSelection(Q3TextDocument::Standard, selstart, selend); + parag->format(); + if (parag->at(selstart)->x < offset || + parag->at(selend)->x + parag->string()->width(selend) > offset + sz.width()) { + offset = parag->at(selstart)->x; + } + } + } +private: + bool frm; + Q3TextParagraph *parag; + Q3TextCursor *cursor; + QSize sz; + int focusSec; + QList< QNumberSection > sections; + QString sep; + int offset; +}; + +class Q3DateTimeEditor : public QWidget +{ + Q_OBJECT +public: + Q3DateTimeEditor(Q3DateTimeEditBase *widget, QWidget *parent, const char* name=0); + ~Q3DateTimeEditor(); + + void setControlWidget(Q3DateTimeEditBase * widget); + Q3DateTimeEditBase * controlWidget() const; + + void setSeparator(const QString& s); + QString separator() const; + + int focusSection() const; + bool setFocusSection(int s); + void appendSection(const QNumberSection& sec); + void clearSections(); + void setSectionSelection(int sec, int selstart, int selend); + bool eventFilter(QObject *o, QEvent *e); + int sectionAt(const QPoint &p); + int mapSection(int sec); + +protected: + void init(); + bool event(QEvent *e); + void resizeEvent(QResizeEvent *); + void paintEvent(QPaintEvent *); + void mousePressEvent(QMouseEvent *e); + +private: + Q3DateTimeEditBase* cw; + Q3DateTimeEditorPrivate* d; +}; + +class QDateTimeSpinWidget : public Q3SpinWidget +{ + Q_OBJECT +public: + QDateTimeSpinWidget(QWidget *parent, const char *name) + : Q3SpinWidget(parent, name) + { + } + + void changeEvent(QEvent *e) + { + if (e->type() == QEvent::EnabledChange && isEnabled()) { + Q3DateEdit *de = qobject_cast<Q3DateEdit*>(parentWidget()); + if (de) { + setUpEnabled(de->date() < de->maxValue()); + setDownEnabled(de->date() > de->minValue()); + } else { + setUpEnabled(true); + setDownEnabled(true); + } + } + } + void enabledChange(bool notenabled) + { + Q3DateEdit *de = qobject_cast<Q3DateEdit*>(parentWidget()); + if (de && !notenabled) { + setUpEnabled(de->date() < de->maxValue()); + setDownEnabled(de->date() > de->minValue()); + } else { + setUpEnabled(!notenabled); + setDownEnabled(!notenabled); + } + } + + +protected: +#ifndef QT_NO_WHEELEVENT + void wheelEvent(QWheelEvent *e) + { + Q3DateTimeEditor *editor = qobject_cast<Q3DateTimeEditor*>(editWidget()); + Q_ASSERT(editor); + if (!editor) + return; + + int section = editor->sectionAt(e->pos()); + editor->setFocusSection(section); + + if (section == -1) + return; + Q3SpinWidget::wheelEvent(e); + } +#endif +}; + +/*! + Constructs an empty datetime editor with parent \a parent and + called \a name. +*/ +Q3DateTimeEditor::Q3DateTimeEditor(Q3DateTimeEditBase *widget, QWidget *parent, const char * name) + : QWidget(parent, name) +{ + d = new Q3DateTimeEditorPrivate(); + cw = widget; + init(); +} + +/*! + Destroys the object and frees any allocated resources. +*/ + +Q3DateTimeEditor::~Q3DateTimeEditor() +{ + delete d; +} + +/*! \internal + +*/ + +void Q3DateTimeEditor::init() +{ + setBackgroundRole(QPalette::Base); + setFocusSection(-1); + installEventFilter(this); + setFocusPolicy(Qt::WheelFocus); +} + + +/*! \reimp + +*/ + +bool Q3DateTimeEditor::event(QEvent *e) +{ + if (e->type() == QEvent::FocusIn || e->type() == QEvent::FocusOut) { + if (e->type() == QEvent::FocusOut) + qApp->sendEvent(cw, e); + update(rect()); + } else if (e->type() == QEvent::ShortcutOverride) { + QKeyEvent* ke = (QKeyEvent*) e; + switch (ke->key()) { + case Qt::Key_Delete: + case Qt::Key_Backspace: + case Qt::Key_Up: + case Qt::Key_Down: + case Qt::Key_Left: + case Qt::Key_Right: + ke->accept(); + default: + break; + } + } + return QWidget::event(e); +} + +/*! \reimp + +*/ + +void Q3DateTimeEditor::resizeEvent(QResizeEvent *e) +{ + d->resize(e->size()); + QWidget::resizeEvent(e); +} + + +/*! \reimp + +*/ + +void Q3DateTimeEditor::paintEvent(QPaintEvent *) +{ + QString txt; + for (uint i = 0; i < d->sectionCount(); ++i) { + txt += cw->sectionFormattedText(i); + if (i < d->sectionCount()-1) { + if (d->section(i+1).separator()) + txt += d->separator(); + else + txt += QLatin1Char(' '); + } + } + + QPainter p(this); + const QBrush &bg = palette().brush(isEnabled() ? QPalette::Base : QPalette::Window); + p.fillRect(0, 0, width(), height(), bg); + d->paint(txt, hasFocus(), p, palette(), rect(), style()); +} + + +/*! + Returns the section index at point \a p. +*/ +int Q3DateTimeEditor::sectionAt(const QPoint &p) +{ + return d->section(p); +} + +int Q3DateTimeEditor::mapSection(int sec) +{ + return d->mapSection(sec); +} + + +/*! \reimp + +*/ + +void Q3DateTimeEditor::mousePressEvent(QMouseEvent *e) +{ + QPoint p(e->pos().x(), 0); + int sec = sectionAt(p); + if (sec != -1) { + cw->setFocusSection(sec); + repaint(rect()); + } +} + +/*! \reimp + +*/ +bool Q3DateTimeEditor::eventFilter(QObject *o, QEvent *e) +{ + if (o == this) { + if (e->type() == QEvent::KeyPress) { + QKeyEvent *ke = (QKeyEvent*)e; + switch (ke->key()) { + case Qt::Key_Right: + if (d->focusSection() < (int)d->sectionCount()-1) { + if (cw->setFocusSection(focusSection()+1)) + repaint(rect()); + } + return true; + case Qt::Key_Left: + if (d->focusSection() > 0) { + if (cw->setFocusSection(focusSection()-1)) + repaint(rect()); + } + return true; + case Qt::Key_Up: + cw->stepUp(); + return true; + case Qt::Key_Down: + cw->stepDown(); + return true; + case Qt::Key_Backspace: + if (qobject_cast<Q3DateEdit*>(cw)) + ((Q3DateEdit*)cw)->removeFirstNumber(d->focusSection()); + else if (qobject_cast<Q3TimeEdit*>(cw)) + ((Q3TimeEdit*)cw)->removeFirstNumber(d->focusSection()); + return true; + case Qt::Key_Delete: + cw->removeLastNumber(d->focusSection()); + return true; + case Qt::Key_Tab: + case Qt::Key_BackTab: { + if (ke->state() == Qt::ControlButton) + return false; + QWidget *w = this; + bool hadDateEdit = false; + while (w) { + if (qobject_cast<QDateTimeSpinWidget*>(w) || qobject_cast<Q3DateTimeEdit*>(w)) + break; + hadDateEdit = hadDateEdit || qobject_cast<Q3DateEdit*>(w); + w = w->parentWidget(); + } + if (w) { + if (!qobject_cast<Q3DateTimeEdit*>(w)) { + w = w->parentWidget(); + } else { + Q3DateTimeEdit *ed = (Q3DateTimeEdit*)w; + if (hadDateEdit && ke->key() == Qt::Key_Tab) { + ed->timeEdit()->setFocus(); + return true; + } else if (!hadDateEdit && ke->key() == Qt::Key_BackTab) { + ed->dateEdit()->setFocus(); + return true; + } else { + while (w && !qobject_cast<Q3DateTimeEdit*>(w)) + w = w->parentWidget(); + } + } + qApp->sendEvent(w, e); + return true; + } + } break; + default: + QString txt = ke->text().toLower(); + if (!txt.isEmpty() && !separator().isEmpty() && txt[0] == separator()[0]) { + // do the same thing as KEY_RIGHT when the user presses the separator key + if (d->focusSection() < 2) { + if (cw->setFocusSection(focusSection()+1)) + repaint(rect()); + } + return true; + } else if (!txt.isEmpty() && qobject_cast<Q3TimeEdit*>(cw) && focusSection() == (int) d->sectionCount()-1) { + // the first character of the AM/PM indicator toggles if the section has focus + Q3TimeEdit *te = (Q3TimeEdit*)cw; + QTime time = te->time(); + if (lAMPM && lAM && lPM && (te->display()&Q3TimeEdit::AMPM)) { + if (txt[0] == (*lAM).toLower()[0] && time.hour() >= 12) { + time.setHMS(time.hour()-12, time.minute(), time.second(), time.msec()); + te->setTime(time); + } else if (txt[0] == (*lPM).toLower()[0] && time.hour() < 12) { + time.setHMS(time.hour()+12, time.minute(), time.second(), time.msec()); + te->setTime(time); + } + } + } + + int num = txt[0].digitValue(); + if (num != -1) { + cw->addNumber(d->focusSection(), num); + return true; + } + } + } + } + return false; +} + + +/*! + Appends the number section \a sec to the editor. +*/ + +void Q3DateTimeEditor::appendSection(const QNumberSection& sec) +{ + d->appendSection(sec); +} + +/*! + Removes all sections from the editor. +*/ + +void Q3DateTimeEditor::clearSections() +{ + d->clearSections(); +} + +/*! + Sets the selection of \a sec to start at \a selstart and end at \a + selend. +*/ + +void Q3DateTimeEditor::setSectionSelection(int sec, int selstart, int selend) +{ + d->setSectionSelection(sec, selstart, selend); +} + +/*! + Sets the separator for all numbered sections to \a s. Note that + currently, only the first character of \a s is used. +*/ + +void Q3DateTimeEditor::setSeparator(const QString& s) +{ + d->setSeparator(s); + update(); +} + + +/*! + Returns the editor's separator. +*/ + +QString Q3DateTimeEditor::separator() const +{ + return d->separator(); +} + +/*! + Returns the number of the section that has focus. +*/ + +int Q3DateTimeEditor::focusSection() const +{ + return d->focusSection(); +} + + +/*! + Sets the focus to section \a sec. If \a sec does not exist, + nothing happens. +*/ + +bool Q3DateTimeEditor::setFocusSection(int sec) +{ + return d->setFocusSection(sec); +} + +/*! + \class Q3DateTimeEditBase + \brief The Q3DateTimeEditBase class provides an abstraction for date and edit editors. + + \compat + + Small abstract class that provides some functions that are common + for both Q3DateEdit and Q3TimeEdit. It is used internally by + Q3DateTimeEditor. +*/ + +/*! + \fn Q3DateTimeEditBase::Q3DateTimeEditBase(QWidget *, const char*) + \internal +*/ + +/*! + \fn Q3DateTimeEditBase::setFocusSection(int) + \internal +*/ + +/*! \fn QString Q3DateTimeEditBase::sectionFormattedText(int sec) + \internal + + Pure virtual function which returns the formatted text of section \a + sec. + +*/ + +/*! \fn void Q3DateTimeEditBase::stepUp() + \internal + + Pure virtual slot which is called whenever the user increases the + number in a section by pressing the widget's arrow buttons or the + keyboard's arrow keys. +*/ + +/*! \fn void Q3DateTimeEditBase::stepDown() + \internal + + Pure virtual slot which is called whenever the user decreases the + number in a section by pressing the widget's arrow buttons or the + keyboard's arrow keys. + +*/ + +/*! \fn void Q3DateTimeEditBase::addNumber(int sec, int num) + \internal + + Pure virtual function which is called whenever the user types a number. + \a sec indicates the section where the number should be added. \a + num is the number that was pressed. +*/ + +/*! \fn void Q3DateTimeEditBase::removeLastNumber(int sec) + \internal + + Pure virtual function which is called whenever the user tries to + remove the last number from \a sec by pressing the delete key. +*/ + +//////////////// + +class Q3DateEditPrivate +{ +public: + int y; + int m; + int d; + // remembers the last entry for the day. + // if the day is 31 and you cycle through the months, + // the day will be 31 again if you reach a month with 31 days + // otherwise it will be the highest day in the month + int dayCache; + int yearSection; + int monthSection; + int daySection; + Q3DateEdit::Order ord; + bool overwrite; + bool adv; + int timerId; + bool typing; + QDate min; + QDate max; + bool changed; + Q3DateTimeEditor *ed; + Q3SpinWidget *controls; +}; + + +/*! + \class Q3DateEdit + \brief The Q3DateEdit class provides a date editor. + + \compat + + Q3DateEdit allows the user to edit dates by using the keyboard or + the arrow keys to increase/decrease date values. The arrow keys + can be used to move from section to section within the Q3DateEdit + box. Dates appear in accordance with the local date/time settings + or in year, month, day order if the system doesn't provide this + information. It is recommended that the Q3DateEdit be initialised + with a date, e.g. + + \snippet doc/src/snippets/code/src_qt3support_widgets_q3datetimeedit.cpp 0 + + Here we've created a new Q3DateEdit object initialised 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. If the auto + advance property is true (as we've set it here) when the user + completes a section of the date, e.g. enters two digits for the + month, they are automatically taken to the next section. + + The maximum and minimum values for a date value in the date editor + default to the maximum and minimum values for a QDate. You can + change this by calling setMinValue(), setMaxValue() or setRange(). + + Terminology: A Q3DateEdit widget comprises three 'sections', one + each for the year, month and day. You can change the separator + character using Q3DateTimeEditor::setSeparator(), by default the + separator will be taken from the systems settings. If that is + not possible, it defaults to "-". + + \img datetimewidgets.png Date Time Widgets + + \sa QDate Q3TimeEdit Q3DateTimeEdit +*/ + +/*! + \enum Q3DateEdit::Order + + This enum defines the order in which the sections that comprise a + date appear. + + \value MDY month-day-year + \value DMY day-month-year + \value YMD year-month-day (the default) + \omitvalue YDM +*/ + +/*! + \enum Q3TimeEdit::Display + + This enum defines the sections that comprise a time + + \value Hours The hours section + \value Minutes The minutes section + \value Seconds The seconds section + \value AMPM The AM/PM section + + The values can be or'ed together to show any combination. +*/ + +/*! + Constructs an empty date editor which is a child of \a parent and + called name \a name. +*/ + +Q3DateEdit::Q3DateEdit(QWidget * parent, const char * name) + : Q3DateTimeEditBase(parent, name) +{ + init(); + updateButtons(); +} + +/*! + \overload + + Constructs a date editor with the initial value \a date, parent \a + parent and called \a name. + + The date editor is initialized with \a date. +*/ + +Q3DateEdit::Q3DateEdit(const QDate& date, QWidget * parent, const char * name) + : Q3DateTimeEditBase(parent, name) +{ + init(); + setDate(date); +} + +/*! \internal +*/ +void Q3DateEdit::init() +{ + d = new Q3DateEditPrivate(); + d->controls = new QDateTimeSpinWidget(this, 0); + d->ed = new Q3DateTimeEditor(this, d->controls); + d->controls->setEditWidget(d->ed); + setFocusProxy(d->ed); + connect(d->controls, SIGNAL(stepUpPressed()), SLOT(stepUp())); + connect(d->controls, SIGNAL(stepDownPressed()), SLOT(stepDown())); + connect(this, SIGNAL(valueChanged(QDate)), SLOT(updateButtons())); + d->ed->appendSection(QNumberSection(0,4)); + d->ed->appendSection(QNumberSection(5,7)); + d->ed->appendSection(QNumberSection(8,10)); + + d->yearSection = -1; + d->monthSection = -1; + d->daySection = -1; + + d->y = 0; + d->m = 0; + d->d = 0; + d->dayCache = 0; + setOrder(localOrder()); + setFocusSection(0); + d->overwrite = true; + d->adv = false; + d->timerId = 0; + d->typing = false; + d->min = QDate(1752, 9, 14); + d->max = QDate(8000, 12, 31); + d->changed = false; + + setSizePolicy(QSizePolicy::Minimum, QSizePolicy::Fixed); + + refcount++; +} + +/*! + Destroys the object and frees any allocated resources. +*/ + +Q3DateEdit::~Q3DateEdit() +{ + delete d; + if (!--refcount) + cleanup(); +} + +/*! + \property Q3DateEdit::minValue + + \brief the editor's minimum value + + Setting the minimum date value is equivalent to calling + Q3DateEdit::setRange(\e d, maxValue()), where \e d is the minimum + date. The default minimum date is 1752-09-14. + + \sa maxValue setRange() +*/ + +QDate Q3DateEdit::minValue() const +{ + return d->min; +} + +/*! + \property Q3DateEdit::maxValue + + \brief the editor's maximum value + + Setting the maximum date value for the editor is equivalent to + calling Q3DateEdit::setRange(minValue(), \e d), where \e d is the + maximum date. The default maximum date is 8000-12-31. + + \sa minValue setRange() +*/ + +QDate Q3DateEdit::maxValue() const +{ + return d->max; +} + + +/*! + Sets the valid input range for the editor to be from \a min to \a + max inclusive. If \a min is invalid no minimum date will be set. + Similarly, if \a max is invalid no maximum date will be set. +*/ + +void Q3DateEdit::setRange(const QDate& min, const QDate& max) +{ + if (min.isValid()) + d->min = min; + if (max.isValid()) + d->max = max; +} + +/*! + Sets the separator to \a s. Note that currently only the first + character of \a s is used. +*/ + +void Q3DateEdit::setSeparator(const QString& s) +{ + d->ed->setSeparator(s); +} + +/*! + Returns the editor's separator. +*/ + +QString Q3DateEdit::separator() const +{ + return d->ed->separator(); +} + + +/*! + Enables/disables the push buttons according to the min/max date + for this widget. +*/ + +void Q3DateEdit::updateButtons() +{ + if (!isEnabled()) + return; + + bool upEnabled = date() < maxValue(); + bool downEnabled = date() > minValue(); + + d->controls->setUpEnabled(upEnabled); + d->controls->setDownEnabled(downEnabled); +} + +/*! \reimp + */ +void Q3DateEdit::resizeEvent(QResizeEvent *) +{ + d->controls->resize(width(), height()); +} + +/*! \reimp + +*/ +QSize Q3DateEdit::sizeHint() const +{ + ensurePolished(); + QFontMetrics fm(font()); + int fw = style()->pixelMetric(QStyle::PM_DefaultFrameWidth, 0, this); + int h = qMax(fm.lineSpacing(), 14) + 2; + int w = 2 + fm.width(QLatin1Char('9')) * 8 + fm.width(d->ed->separator()) * 2 + d->controls->upRect().width() + fw * 4; + + return QSize(w, qMax(h + fw * 2,20)).expandedTo(QApplication::globalStrut()); +} + +/*! \reimp + +*/ +QSize Q3DateEdit::minimumSizeHint() const +{ + return sizeHint(); +} + + +/*! + Returns the formatted number for section \a sec. This will + correspond to either the year, month or day section, depending on + the current display order. + + \sa setOrder() +*/ + +QString Q3DateEdit::sectionFormattedText(int sec) +{ + QString txt; + txt = sectionText(sec); + if (d->typing && sec == d->ed->focusSection()) + d->ed->setSectionSelection(sec, sectionOffsetEnd(sec) - txt.length(), + sectionOffsetEnd(sec)); + else + d->ed->setSectionSelection(sec, sectionOffsetEnd(sec) - sectionLength(sec), + sectionOffsetEnd(sec)); + txt = txt.rightJustified(sectionLength(sec), QDATETIMEEDIT_HIDDEN_CHAR); + return txt; +} + + +/*! + Returns the desired length (number of digits) of section \a sec. + This will correspond to either the year, month or day section, + depending on the current display order. + + \sa setOrder() +*/ + +int Q3DateEdit::sectionLength(int sec) const +{ + int val = 0; + if (sec == d->yearSection) { + val = 4; + } else if (sec == d->monthSection) { + val = 2; + } else if (sec == d->daySection) { + val = 2; + } + return val; +} + +/*! + Returns the text of section \a sec. This will correspond to either + the year, month or day section, depending on the current display + order. + + \sa setOrder() +*/ + +QString Q3DateEdit::sectionText(int sec) const +{ + int val = 0; + if (sec == d->yearSection) { + val = d->y; + } else if (sec == d->monthSection) { + val = d->m; + } else if (sec == d->daySection) { + val = d->d; + } + return QString::number(val); +} + +/*! \internal + + Returns the end of the section offset \a sec. + +*/ + +int Q3DateEdit::sectionOffsetEnd(int sec) const +{ + if (sec == d->yearSection) { + switch(d->ord) { + case DMY: + case MDY: + return sectionOffsetEnd(sec-1) + separator().length() + sectionLength(sec); + case YMD: + case YDM: + return sectionLength(sec); + } + } else if (sec == d->monthSection) { + switch(d->ord) { + case DMY: + case YDM: + case YMD: + return sectionOffsetEnd(sec-1) + separator().length() + sectionLength(sec); + case MDY: + return sectionLength(sec); + } + } else if (sec == d->daySection) { + switch(d->ord) { + case DMY: + return sectionLength(sec); + case YMD: + case MDY: + case YDM: + return sectionOffsetEnd(sec-1) + separator().length() + sectionLength(sec); + } + } + return 0; +} + + +/*! + \property Q3DateEdit::order + \brief the order in which the year, month and day appear + + The default order is locale dependent. + + \sa Order +*/ + +void Q3DateEdit::setOrder(Q3DateEdit::Order order) +{ + d->ord = order; + switch(d->ord) { + case DMY: + d->yearSection = 2; + d->monthSection = 1; + d->daySection = 0; + break; + case MDY: + d->yearSection = 2; + d->monthSection = 0; + d->daySection = 1; + break; + case YMD: + d->yearSection = 0; + d->monthSection = 1; + d->daySection = 2; + break; + case YDM: + d->yearSection = 0; + d->monthSection = 2; + d->daySection = 1; + break; + } + if (isVisible()) + d->ed->repaint(d->ed->rect()); +} + + +Q3DateEdit::Order Q3DateEdit::order() const +{ + return d->ord; +} + + +/*! \reimp + +*/ +void Q3DateEdit::stepUp() +{ + int sec = d->ed->focusSection(); + bool accepted = false; + if (sec == d->yearSection) { + if (!outOfRange(d->y+1, d->m, d->d)) { + accepted = true; + setYear(d->y+1); + } + } else if (sec == d->monthSection) { + if (!outOfRange(d->y, d->m+1, d->d)) { + accepted = true; + setMonth(d->m+1); + } + } else if (sec == d->daySection) { + if (!outOfRange(d->y, d->m, d->d+1)) { + accepted = true; + setDay(d->d+1); + } + } + if (accepted) { + d->changed = false; + emit valueChanged(date()); + } + d->ed->repaint(d->ed->rect()); +} + + + +/*! \reimp + +*/ + +void Q3DateEdit::stepDown() +{ + int sec = d->ed->focusSection(); + bool accepted = false; + if (sec == d->yearSection) { + if (!outOfRange(d->y-1, d->m, d->d)) { + accepted = true; + setYear(d->y-1); + } + } else if (sec == d->monthSection) { + if (!outOfRange(d->y, d->m-1, d->d)) { + accepted = true; + setMonth(d->m-1); + } + } else if (sec == d->daySection) { + if (!outOfRange(d->y, d->m, d->d-1)) { + accepted = true; + setDay(d->d-1); + } + } + if (accepted) { + d->changed = false; + emit valueChanged(date()); + } + d->ed->repaint(d->ed->rect()); +} + +/*! + Sets the year to \a year, which must be a valid year. The range + currently supported is from 1752 to 8000. + + \sa QDate +*/ + +void Q3DateEdit::setYear(int year) +{ + if (year < 1752) + year = 1752; + if (year > 8000) + year = 8000; + if (!outOfRange(year, d->m, d->d)) { + d->y = year; + setMonth(d->m); + int tmp = d->dayCache; + setDay(d->dayCache); + d->dayCache = tmp; + } +} + + +/*! + Sets the month to \a month, which must be a valid month, i.e. + between 1 and 12. +*/ + +void Q3DateEdit::setMonth(int month) +{ + if (month < 1) + month = 1; + if (month > 12) + month = 12; + if (!outOfRange(d->y, month, d->d)) { + d->m = month; + int tmp = d->dayCache; + setDay(d->dayCache); + d->dayCache = tmp; + } +} + + +/*! + Sets the day to \a day, which must be a valid day. The function + will ensure that the \a day set is valid for the month and year. +*/ + +void Q3DateEdit::setDay(int day) +{ + if (day < 1) + day = 1; + if (day > 31) + day = 31; + if (d->m > 0 && d->y > 1752) { + while (!QDate::isValid(d->y, d->m, day)) + --day; + if (!outOfRange(d->y, d->m, day)) + d->d = day; + } else if (d->m > 0) { + if (day > 0 && day < 32) { + if (!outOfRange(d->y, d->m, day)) + d->d = day; + } + } + d->dayCache = d->d; +} + + +/*! + \property Q3DateEdit::date + \brief the editor's date value. + + If the date property is not valid, the editor displays all zeroes + and Q3DateEdit::date() will return an invalid date. It is strongly + recommended that the editor is given a default date value (e.g. + currentDate()). That way, attempts to set the date property to an + invalid date will fail. + + When changing the date property, if the date is less than + minValue(), or is greater than maxValue(), nothing happens. +*/ + +void Q3DateEdit::setDate(const QDate& date) +{ + if (!date.isValid()) { + d->y = 0; + d->m = 0; + d->d = 0; + d->dayCache = 0; + } else { + if (date > maxValue() || date < minValue()) + return; + d->y = date.year(); + d->m = date.month(); + d->d = date.day(); + d->dayCache = d->d; + emit valueChanged(date); + } + d->changed = false; + d->ed->repaint(d->ed->rect()); +} + +QDate Q3DateEdit::date() const +{ + if (QDate::isValid(d->y, d->m, d->d)) + return QDate(d->y, d->m, d->d); + return QDate(); +} + +/*! \internal + + Returns true if \a y, \a m, \a d is out of range, otherwise returns + false. + + \sa setRange() + +*/ + +bool Q3DateEdit::outOfRange(int y, int m, int d) const +{ + if (QDate::isValid(y, m, d)) { + QDate currentDate(y, m, d); + if (currentDate > maxValue() || + currentDate < minValue()) { + //## outOfRange should set overwrite? + return true; + } + return false; + } + return false; /* assume ok */ +} + +/*! \reimp + +*/ + +void Q3DateEdit::addNumber(int sec, int num) +{ + if (sec == -1) + return; + if (d->timerId) + killTimer(d->timerId); + d->timerId = 0; + bool overwrite = false; + bool accepted = false; + d->typing = true; + QString txt; + if (sec == d->yearSection) { + txt = QString::number(d->y); + if (d->overwrite || txt.length() == 4) { + accepted = true; + d->y = num; + } else { + txt += QString::number(num); + if (txt.length() == 4 ) { + const int val = qBound(1792, txt.toInt(), 8000); + if (outOfRange(val, d->m, d->d)) { + txt = QString::number(d->y); + } else { + accepted = true; + d->y = val; + } + } else { + accepted = true; + d->y = txt.toInt(); + } + if (d->adv && txt.length() == 4) { + d->ed->setFocusSection(d->ed->focusSection()+1); + overwrite = true; + } + } + } else if (sec == d->monthSection) { + txt = QString::number(d->m); + if (d->overwrite || txt.length() == 2) { + accepted = true; + d->m = num; + } else { + txt += QString::number(num); + int temp = txt.toInt(); + if (temp > 12) + temp = num; + if (outOfRange(d->y, temp, d->d)) + txt = QString::number(d->m); + else { + accepted = true; + d->m = temp; + } + if (d->adv && txt.length() == 2) { + d->ed->setFocusSection(d->ed->focusSection()+1); + overwrite = true; + } + } + } else if (sec == d->daySection) { + txt = QString::number(d->d); + if (d->overwrite || txt.length() == 2) { + accepted = true; + d->d = num; + d->dayCache = d->d; + } else { + txt += QString::number(num); + int temp = txt.toInt(); + if (temp > 31) + temp = num; + if (outOfRange(d->y, d->m, temp)) + txt = QString::number(d->d); + else { + accepted = true; + d->d = temp; + d->dayCache = d->d; + } + if (d->adv && txt.length() == 2) { + d->ed->setFocusSection(d->ed->focusSection()+1); + overwrite = true; + } + } + } + if (accepted) { + d->changed = false; + emit valueChanged(date()); + } + d->overwrite = overwrite; + d->timerId = startTimer(qApp->doubleClickInterval()*4); + d->ed->repaint(d->ed->rect()); +} + + +/*! \reimp + +*/ + +bool Q3DateEdit::setFocusSection(int s) +{ + if (s != d->ed->focusSection()) { + if (d->timerId) + killTimer(d->timerId); + d->timerId = 0; + d->overwrite = true; + d->typing = false; + fix(); // will emit valueChanged if necessary + } + return d->ed->setFocusSection(s); +} + + +/*! + Attempts to fix any invalid date entries. + + The rules applied are as follows: + + \list + \i If the year has four digits it is left unchanged. + \i If the year has two digits, the year will be changed to four + digits in the range current year - 70 to current year + 29. + \i If the year has three digits in the range 100..999, the + current millennium, i.e. 2000, will be added giving a year + in the range 2100..2999. + \i If the day or month is 0 then it will be set to 1 or the + minimum valid day/month in the range. + \endlist +*/ + +void Q3DateEdit::fix() +{ + bool changed = false; + int currentYear = QDate::currentDate().year(); + int year = d->y; + if (year < 100) { + int currentCentury = currentYear / 100; + year += currentCentury * 100; + if (currentYear > year) { + if (currentYear > year + 70) + year += 100; + } else { + if (year >= currentYear + 30) + year -= 100; + } + changed = true; + } else if (year < 1000) { + int currentMillennium = currentYear / 10; + year += currentMillennium * 10; + changed = true; + } else if (d->d == 0) { + d->d = 1; + changed = true; + } else if (d->m == 0) { + d->m = 1; + changed = true; + } + if (outOfRange(year, d->m, d->d)) { + if (minValue().isValid() && date() < minValue()) { + d->d = minValue().day(); + d->dayCache = d->d; + d->m = minValue().month(); + d->y = minValue().year(); + } + if (date() > maxValue()) { + d->d = maxValue().day(); + d->dayCache = d->d; + d->m = maxValue().month(); + d->y = maxValue().year(); + } + changed = true; + } else if (changed) + setYear(year); + if (changed) { + emit valueChanged(date()); + d->changed = false; + } +} + + +/*! \reimp + +*/ + +bool Q3DateEdit::event(QEvent *e) +{ + if(e->type() == QEvent::FocusOut) { + d->typing = false; + fix(); + // the following can't be done in fix() because fix() called + // from all over the place and it will break the old behaviour + if (!QDate::isValid(d->y, d->m, d->d)) { + d->dayCache = d->d; + int i = d->d; + for (; i > 0; i--) { + d->d = i; + if (QDate::isValid(d->y, d->m, d->d)) + break; + } + d->changed = true; + } + if (d->changed) { + emit valueChanged(date()); + d->changed = false; + } + } else if (e->type() == QEvent::LocaleChange) { + readLocaleSettings(); + d->ed->setSeparator(localDateSep()); + setOrder(localOrder()); + } + return Q3DateTimeEditBase::event(e); +} + +/*! + \internal + + Function which is called whenever the user tries to + remove the first number from \a sec by pressing the backspace key. +*/ + +void Q3DateEdit::removeFirstNumber(int sec) +{ + if (sec == -1) + return; + QString txt; + if (sec == d->yearSection) { + txt = QString::number(d->y); + txt = txt.mid(1, txt.length()) + QLatin1Char('0'); + d->y = txt.toInt(); + } else if (sec == d->monthSection) { + txt = QString::number(d->m); + txt = txt.mid(1, txt.length()) + QLatin1Char('0'); + d->m = txt.toInt(); + } else if (sec == d->daySection) { + txt = QString::number(d->d); + txt = txt.mid(1, txt.length()) + QLatin1Char('0'); + d->d = txt.toInt(); + d->dayCache = d->d; + } + d->ed->repaint(d->ed->rect()); +} + +/*! \reimp + +*/ + +void Q3DateEdit::removeLastNumber(int sec) +{ + if (sec == -1) + return; + QString txt; + if (sec == d->yearSection) { + txt = QString::number(d->y); + txt = txt.mid(0, txt.length()-1); + d->y = txt.toInt(); + } else if (sec == d->monthSection) { + txt = QString::number(d->m); + txt = txt.mid(0, txt.length()-1); + d->m = txt.toInt(); + } else if (sec == d->daySection) { + txt = QString::number(d->d); + txt = txt.mid(0, txt.length()-1); + d->d = txt.toInt(); + d->dayCache = d->d; + } + d->ed->repaint(d->ed->rect()); +} + +/*! + \property Q3DateEdit::autoAdvance + \brief whether the editor automatically advances to the next + section + + If autoAdvance is true, the editor will automatically advance + focus to the next date section if a user has completed a section. + The default is false. +*/ + +void Q3DateEdit::setAutoAdvance(bool advance) +{ + d->adv = advance; +} + + +bool Q3DateEdit::autoAdvance() const +{ + return d->adv; +} + +/*! \reimp +*/ + +void Q3DateEdit::timerEvent(QTimerEvent *) +{ + d->overwrite = true; +} + +/*! + \fn void Q3DateEdit::valueChanged(const QDate& date) + + This signal is emitted whenever the editor's value changes. The \a + date parameter is the new value. +*/ + +/////////// + +class Q3TimeEditPrivate +{ +public: + int h; + int m; + int s; + uint display; + bool adv; + bool overwrite; + int timerId; + bool typing; + QTime min; + QTime max; + bool changed; + Q3DateTimeEditor *ed; + Q3SpinWidget *controls; +}; + +/*! + \class Q3TimeEdit + \brief The Q3TimeEdit class provides a time editor. + + \compat + + Q3TimeEdit allows the user to edit times by using the keyboard or + the arrow keys to increase/decrease time values. The arrow keys + can be used to move from section to section within the Q3TimeEdit + box. The user can automatically be moved to the next section once + they complete a section using setAutoAdvance(). Times appear in + hour, minute, second order. It is recommended that the Q3TimeEdit + is initialised with a time, e.g. + \snippet doc/src/snippets/code/src_qt3support_widgets_q3datetimeedit.cpp 1 + Here we've created a Q3TimeEdit widget set to the current time. + We've also set the minimum value to the current time and the + maximum time to one hour from now. + + The maximum and minimum values for a time value in the time editor + default to the maximum and minimum values for a QTime. You can + change this by calling setMinValue(), setMaxValue() or setRange(). + + Terminology: A QTimeWidget consists of three sections, one each + for the hour, minute and second. You can change the separator + character using setSeparator(), by default the separator is read + from the system's settings. + + \img datetimewidgets.png Date Time Widgets + + \sa QTime Q3DateEdit Q3DateTimeEdit +*/ + + +/*! + Constructs an empty time edit with parent \a parent and called \a + name. +*/ + +Q3TimeEdit::Q3TimeEdit(QWidget * parent, const char * name) + : Q3DateTimeEditBase(parent, name) +{ + init(); +} + +/*! + \overload + + Constructs a time edit with the initial time value, \a time, + parent \a parent and called \a name. +*/ + +Q3TimeEdit::Q3TimeEdit(const QTime& time, QWidget * parent, const char * name) + : Q3DateTimeEditBase(parent, name) +{ + init(); + setTime(time); +} + +/*! \internal + */ + +void Q3TimeEdit::init() +{ + d = new Q3TimeEditPrivate(); + d->controls = new QDateTimeSpinWidget(this, 0); + d->ed = new Q3DateTimeEditor(this, d->controls, "time edit base"); + d->controls->setEditWidget(d->ed); + setFocusProxy(d->ed); + connect(d->controls, SIGNAL(stepUpPressed()), SLOT(stepUp())); + connect(d->controls, SIGNAL(stepDownPressed()), SLOT(stepDown())); + + d->ed->appendSection(QNumberSection(0,0, true, 0)); + d->ed->appendSection(QNumberSection(0,0, true, 1)); + d->ed->appendSection(QNumberSection(0,0, true, 2)); + d->ed->setSeparator(localTimeSep()); + + d->h = 0; + d->m = 0; + d->s = 0; + d->display = Hours | Minutes | Seconds; + if (lAMPM) { + d->display |= AMPM; + d->ed->appendSection(QNumberSection(0,0, false, 3)); + } + d->adv = false; + d->overwrite = true; + d->timerId = 0; + d->typing = false; + d->min = QTime(0, 0, 0); + d->max = QTime(23, 59, 59); + d->changed = false; + + setSizePolicy(QSizePolicy::Minimum, QSizePolicy::Fixed); + + refcount++; +} + +/*! + Destroys the object and frees any allocated resources. +*/ + +Q3TimeEdit::~Q3TimeEdit() +{ + delete d; + if (!--refcount) + cleanup(); +} + +/*! + \property Q3TimeEdit::minValue + \brief the minimum time value + + Setting the minimum time value is equivalent to calling + Q3TimeEdit::setRange(\e t, maxValue()), where \e t is the minimum + time. The default minimum time is 00:00:00. + + \sa maxValue setRange() +*/ + +QTime Q3TimeEdit::minValue() const +{ + return d->min; +} + +/*! + \property Q3TimeEdit::maxValue + \brief the maximum time value + + Setting the maximum time value is equivalent to calling + Q3TimeEdit::setRange(minValue(), \e t), where \e t is the maximum + time. The default maximum time is 23:59:59. + + \sa minValue setRange() +*/ + +QTime Q3TimeEdit::maxValue() const +{ + return d->max; +} + + +/*! + Sets the valid input range for the editor to be from \a min to \a + max inclusive. If \a min is invalid no minimum time is set. + Similarly, if \a max is invalid no maximum time is set. +*/ + +void Q3TimeEdit::setRange(const QTime& min, const QTime& max) +{ + if (min.isValid()) + d->min = min; + if (max.isValid()) + d->max = max; +} + +/*! + \property Q3TimeEdit::display + \brief the sections that are displayed in the time edit + + The value can be any combination of the values in the Display enum. + By default, the widget displays hours, minutes and seconds. +*/ +void Q3TimeEdit::setDisplay(uint display) +{ + if (d->display == display) + return; + + d->ed->clearSections(); + d->display = display; + if (d->display & Hours) + d->ed->appendSection(QNumberSection(0,0, true, 0)); + if (d->display & Minutes) + d->ed->appendSection(QNumberSection(0,0, true, 1)); + if (d->display & Seconds) + d->ed->appendSection(QNumberSection(0,0, true, 2)); + if (d->display & AMPM) + d->ed->appendSection(QNumberSection(0,0, false, 3)); + + d->ed->setFocusSection(0); + d->ed->update(); +} + +uint Q3TimeEdit::display() const +{ + return d->display; +} + +/*! + \property Q3TimeEdit::time + \brief the editor's time value. + + When changing the time property, if the time is less than + minValue(), or is greater than maxValue(), nothing happens. +*/ + +void Q3TimeEdit::setTime(const QTime& time) +{ + if (!time.isValid()) { + d->h = 0; + d->m = 0; + d->s = 0; + } else { + if (time > maxValue() || time < minValue()) + return; + d->h = time.hour(); + d->m = time.minute(); + d->s = time.second(); + emit valueChanged(time); + } + d->changed = false; + d->ed->repaint(d->ed->rect()); +} + +QTime Q3TimeEdit::time() const +{ + if (QTime::isValid(d->h, d->m, d->s)) + return QTime(d->h, d->m, d->s); + return QTime(); +} + +/*! + \property Q3TimeEdit::autoAdvance + \brief whether the editor automatically advances to the next + section + + If autoAdvance is true, the editor will automatically advance + focus to the next time section if a user has completed a section. + The default is false. +*/ + +void Q3TimeEdit::setAutoAdvance(bool advance) +{ + d->adv = advance; +} + +bool Q3TimeEdit::autoAdvance() const +{ + return d->adv; +} + +/*! + Sets the separator to \a s. Note that currently only the first + character of \a s is used. +*/ + +void Q3TimeEdit::setSeparator(const QString& s) +{ + d->ed->setSeparator(s); +} + +/*! + Returns the editor's separator. +*/ + +QString Q3TimeEdit::separator() const +{ + return d->ed->separator(); +} + + +/*! + \fn void Q3TimeEdit::valueChanged(const QTime& time) + + This signal is emitted whenever the editor's value changes. The \a + time parameter is the new value. +*/ + +/*! \reimp + +*/ + +bool Q3TimeEdit::event(QEvent *e) +{ + if (e->type() == QEvent::FocusOut) { + d->typing = false; + if (d->changed) { + emit valueChanged(time()); + d->changed = false; + } + } else if (e->type() == QEvent::LocaleChange) { + readLocaleSettings(); + d->ed->setSeparator(localTimeSep()); + } + return Q3DateTimeEditBase::event(e); +} + +/*! \reimp + +*/ + +void Q3TimeEdit::timerEvent(QTimerEvent *) +{ + d->overwrite = true; +} + + +/*! \reimp + +*/ + +void Q3TimeEdit::stepUp() +{ + int sec = d->ed->mapSection(d->ed->focusSection()); + bool accepted = true; + switch(sec) { + case 0: + if (!outOfRange(d->h+1, d->m, d->s)) + setHour(d->h+1); + else + setHour(d->min.hour()); + break; + case 1: + if (!outOfRange(d->h, d->m+1, d->s)) + setMinute(d->m+1); + else + setMinute(d->min.minute()); + break; + case 2: + if (!outOfRange(d->h, d->m, d->s+1)) + setSecond(d->s+1); + else + setSecond(d->min.second()); + break; + case 3: + if (d->h < 12) + setHour(d->h+12); + else + setHour(d->h-12); + break; + default: + accepted = false; + qWarning("Q3TimeEdit::stepUp: Focus section out of range!"); + break; + } + if (accepted) { + d->changed = false; + emit valueChanged(time()); + } + d->ed->repaint(d->ed->rect()); +} + + +/*! \reimp + +*/ + +void Q3TimeEdit::stepDown() +{ + int sec = d->ed->mapSection(d->ed->focusSection()); + + bool accepted = true; + switch(sec) { + case 0: + if (!outOfRange(d->h-1, d->m, d->s)) + setHour(d->h-1); + else + setHour(d->max.hour()); + break; + case 1: + if (!outOfRange(d->h, d->m-1, d->s)) + setMinute(d->m-1); + else + setMinute(d->max.minute()); + break; + case 2: + if (!outOfRange(d->h, d->m, d->s-1)) + setSecond(d->s-1); + else + setSecond(d->max.second()); + break; + case 3: + if (d->h > 11) + setHour(d->h-12); + else + setHour(d->h+12); + break; + default: + accepted = false; + qWarning("Q3TimeEdit::stepDown: Focus section out of range!"); + break; + } + if (accepted) { + d->changed = false; + emit valueChanged(time()); + } + d->ed->repaint(d->ed->rect()); +} + + +/*! + Returns the formatted number for section \a sec. This will + correspond to either the hour, minute or second section, depending + on \a sec. +*/ + +QString Q3TimeEdit::sectionFormattedText(int sec) +{ + QString txt; + txt = sectionText(sec); + txt = txt.rightJustified(2, QDATETIMEEDIT_HIDDEN_CHAR); + int offset = sec*2+sec*separator().length() + txt.length(); + if (d->typing && sec == d->ed->focusSection()) + d->ed->setSectionSelection(sec, offset - txt.length(), offset); + else + d->ed->setSectionSelection(sec, offset - txt.length(), offset); + + return txt; +} + + +/*! \reimp + +*/ + +bool Q3TimeEdit::setFocusSection(int sec) +{ + if (sec != d->ed->focusSection()) { + if (d->timerId) + killTimer(d->timerId); + d->timerId = 0; + d->overwrite = true; + d->typing = false; + QString txt = sectionText(sec); + txt = txt.rightJustified(2, QDATETIMEEDIT_HIDDEN_CHAR); + int offset = sec*2+sec*separator().length() + txt.length(); + d->ed->setSectionSelection(sec, offset - txt.length(), offset); + if (d->changed) { + emit valueChanged(time()); + d->changed = false; + } + } + return d->ed->setFocusSection(sec); +} + + +/*! + Sets the hour to \a h, which must be a valid hour, i.e. in the + range 0..24. +*/ + +void Q3TimeEdit::setHour(int h) +{ + if (h < 0) + h = 0; + if (h > 23) + h = 23; + d->h = h; +} + + +/*! + Sets the minute to \a m, which must be a valid minute, i.e. in the + range 0..59. +*/ + +void Q3TimeEdit::setMinute(int m) +{ + if (m < 0) + m = 0; + if (m > 59) + m = 59; + d->m = m; +} + + +/*! + Sets the second to \a s, which must be a valid second, i.e. in the + range 0..59. +*/ + +void Q3TimeEdit::setSecond(int s) +{ + if (s < 0) + s = 0; + if (s > 59) + s = 59; + d->s = s; +} + + +/*! \internal + + Returns the text of section \a sec. + +*/ + +QString Q3TimeEdit::sectionText(int sec) +{ + sec = d->ed->mapSection(sec); + + QString txt; + switch(sec) { + case 0: + if (!(d->display & AMPM) || (d->h < 13 && d->h)) { // I wished the day stared at 0:00 for everybody + txt = QString::number(d->h); + } else { + if (d->h) + txt = QString::number(d->h - 12); + else + txt = QLatin1String("12"); + } + break; + case 1: + txt = QString::number(d->m); + break; + case 2: + txt = QString::number(d->s); + break; + case 3: + if (d->h < 12) { + if (lAM) + txt = *lAM; + else + txt = QString::fromLatin1("AM"); + } else { + if (lPM) + txt = *lPM; + else + txt = QString::fromLatin1("PM"); + } + break; + default: + break; + } + return txt; +} + + +/*! \internal + Returns true if \a h, \a m, and \a s are out of range. + */ + +bool Q3TimeEdit::outOfRange(int h, int m, int s) const +{ + if (QTime::isValid(h, m, s)) { + QTime currentTime(h, m, s); + if (currentTime > maxValue() || + currentTime < minValue()) + return true; + else + return false; + } + return true; +} + +/*! \reimp + +*/ + +void Q3TimeEdit::addNumber(int sec, int num) +{ + if (sec == -1) + return; + sec = d->ed->mapSection(sec); + if (d->timerId) + killTimer(d->timerId); + d->timerId = 0; + bool overwrite = false; + bool accepted = false; + d->typing = true; + QString txt; + + switch(sec) { + case 0: + txt = (d->display & AMPM && d->h > 12) ? + QString::number(d->h - 12) : QString::number(d->h); + + if (d->overwrite || txt.length() == 2) { + if (d->display & AMPM && num == 0) + break; // Don't process 0 in 12 hour clock mode + if (d->display & AMPM && d->h > 11) + num += 12; + if (!outOfRange(num, d->m, d->s)) { + accepted = true; + d->h = num; + } + } else { + txt += QString::number(num); + int temp = txt.toInt(); + + if (d->display & AMPM) { + if (temp == 12) { + if (d->h < 12) { + temp = 0; + } + accepted = true; + } else if (outOfRange(temp + 12, d->m, d->s)) { + txt = QString::number(d->h); + } else { + if (d->h > 11) { + temp += 12; + } + accepted = true; + } + } else if (!(d->display & AMPM) && outOfRange(temp, d->m, d->s)) { + txt = QString::number(d->h); + } else { + accepted = true; + } + + if (accepted) + d->h = temp; + + if (d->adv && txt.length() == 2) { + setFocusSection(d->ed->focusSection()+1); + overwrite = true; + } + } + break; + + case 1: + txt = QString::number(d->m); + if (d->overwrite || txt.length() == 2) { + if (!outOfRange(d->h, num, d->s)) { + accepted = true; + d->m = num; + } + } else { + txt += QString::number(num); + int temp = txt.toInt(); + if (temp > 59) + temp = num; + if (outOfRange(d->h, temp, d->s)) + txt = QString::number(d->m); + else { + accepted = true; + d->m = temp; + } + if (d->adv && txt.length() == 2) { + setFocusSection(d->ed->focusSection()+1); + overwrite = true; + } + } + break; + + case 2: + txt = QString::number(d->s); + if (d->overwrite || txt.length() == 2) { + if (!outOfRange(d->h, d->m, num)) { + accepted = true; + d->s = num; + } + } else { + txt += QString::number(num); + int temp = txt.toInt(); + if (temp > 59) + temp = num; + if (outOfRange(d->h, d->m, temp)) + txt = QString::number(d->s); + else { + accepted = true; + d->s = temp; + } + if (d->adv && txt.length() == 2) { + setFocusSection(d->ed->focusSection()+1); + overwrite = true; + } + } + break; + + case 3: + break; + + default: + break; + } + d->changed = !accepted; + if (accepted) + emit valueChanged(time()); + d->overwrite = overwrite; + d->timerId = startTimer(qApp->doubleClickInterval()*4); + d->ed->repaint(d->ed->rect()); +} + + +/*! + \internal + + Function which is called whenever the user tries to + remove the first number from \a sec by pressing the backspace key. +*/ + +void Q3TimeEdit::removeFirstNumber(int sec) +{ + if (sec == -1) + return; + sec = d->ed->mapSection(sec); + QString txt; + switch(sec) { + case 0: + txt = QString::number(d->h); + break; + case 1: + txt = QString::number(d->m); + break; + case 2: + txt = QString::number(d->s); + break; + } + txt = txt.mid(1, txt.length()) + QLatin1Char('0'); + switch(sec) { + case 0: + d->h = txt.toInt(); + break; + case 1: + d->m = txt.toInt(); + break; + case 2: + d->s = txt.toInt(); + break; + } + d->ed->repaint(d->ed->rect()); +} + +/*! \reimp + +*/ +void Q3TimeEdit::removeLastNumber(int sec) +{ + if (sec == -1) + return; + sec = d->ed->mapSection(sec); + QString txt; + switch(sec) { + case 0: + txt = QString::number(d->h); + break; + case 1: + txt = QString::number(d->m); + break; + case 2: + txt = QString::number(d->s); + break; + } + txt = txt.mid(0, txt.length()-1); + switch(sec) { + case 0: + d->h = txt.toInt(); + break; + case 1: + d->m = txt.toInt(); + break; + case 2: + d->s = txt.toInt(); + break; + } + d->ed->repaint(d->ed->rect()); +} + +/*! \reimp + */ +void Q3TimeEdit::resizeEvent(QResizeEvent *) +{ + d->controls->resize(width(), height()); +} + +/*! \reimp +*/ +QSize Q3TimeEdit::sizeHint() const +{ + ensurePolished(); + QFontMetrics fm(font()); + int fw = style()->pixelMetric(QStyle::PM_DefaultFrameWidth, 0, this); + int h = fm.lineSpacing() + 2; + int w = 2 + fm.width(QLatin1Char('9')) * 6 + fm.width(d->ed->separator()) * 2 + + d->controls->upRect().width() + fw * 4; + if (d->display & AMPM) { + if (lAM) + w += fm.width(*lAM) + 4; + else + w += fm.width(QString::fromLatin1("AM")) + 4; + } + + return QSize(w, qMax(h + fw * 2,20)).expandedTo(QApplication::globalStrut()); +} + +/*! \reimp +*/ +QSize Q3TimeEdit::minimumSizeHint() const +{ + return sizeHint(); +} + +/*! + \internal + Enables/disables the push buttons according to the min/max time + for this widget. +*/ + +void Q3TimeEdit::updateButtons() +{ + if (!isEnabled()) + return; + + bool upEnabled = time() < maxValue(); + bool downEnabled = time() > minValue(); + + d->controls->setUpEnabled(upEnabled); + d->controls->setDownEnabled(downEnabled); +} + + +class Q3DateTimeEditPrivate +{ +public: + bool adv; +}; + +/*! + \class Q3DateTimeEdit + \brief The Q3DateTimeEdit class combines a Q3DateEdit and Q3TimeEdit + widget into a single widget for editing datetimes. + + \compat + + Q3DateTimeEdit consists of a Q3DateEdit and Q3TimeEdit widget placed + side by side and offers the functionality of both. The user can + edit the date and time by using the keyboard or the arrow keys to + increase/decrease date or time values. The Tab key can be used to + move from section to section within the Q3DateTimeEdit widget, and + the user can be moved automatically when they complete a section + using setAutoAdvance(). The datetime can be set with + setDateTime(). + + The date format is read from the system's locale settings. It is + set to year, month, day order if that is not possible. See + Q3DateEdit::setOrder() to change this. Times appear in the order + hours, minutes, seconds using the 24 hour clock. + + It is recommended that the Q3DateTimeEdit is initialised with a + datetime, e.g. + \snippet doc/src/snippets/code/src_qt3support_widgets_q3datetimeedit.cpp 2 + Here we've created a new Q3DateTimeEdit set to the current date and + time, and set the date to have a minimum date of now and a maximum + date of a week from now. + + Terminology: A Q3DateEdit widget consists of three 'sections', one + each for the year, month and day. Similarly a Q3TimeEdit consists + of three sections, one each for the hour, minute and second. The + character that separates each date section is specified with + setDateSeparator(); similarly setTimeSeparator() is used for the + time sections. + + \img datetimewidgets.png Date Time Widgets + + \sa Q3DateEdit Q3TimeEdit +*/ + +/*! + Constructs an empty datetime edit with parent \a parent and called + \a name. +*/ +Q3DateTimeEdit::Q3DateTimeEdit(QWidget * parent, const char * name) + : QWidget(parent, name) +{ + init(); +} + + +/*! + \overload + + Constructs a datetime edit with the initial value \a datetime, + parent \a parent and called \a name. +*/ +Q3DateTimeEdit::Q3DateTimeEdit(const QDateTime& datetime, + QWidget * parent, const char * name) + : QWidget(parent, name) +{ + init(); + setDateTime(datetime); +} + + + +/*! + Destroys the object and frees any allocated resources. +*/ + +Q3DateTimeEdit::~Q3DateTimeEdit() +{ + delete d; +} + + +/*! + \reimp + + Intercepts and handles resize events which have special meaning + for the Q3DateTimeEdit. +*/ + +void Q3DateTimeEdit::resizeEvent(QResizeEvent *) +{ + int dw = de->sizeHint().width(); + int tw = te->sizeHint().width(); + int w = width(); + int h = height(); + int extra = w - (dw + tw); + + if (tw + extra < 0) { + dw = w; + } else { + dw += 9 * extra / 16; + } + tw = w - dw; + + de->setGeometry(0, 0, dw, h); + te->setGeometry(dw, 0, tw, h); +} + +/*! \reimp +*/ + +QSize Q3DateTimeEdit::minimumSizeHint() const +{ + QSize dsh = de->minimumSizeHint(); + QSize tsh = te->minimumSizeHint(); + return QSize(dsh.width() + tsh.width(), + qMax(dsh.height(), tsh.height())); +} + +/*! \internal + */ + +void Q3DateTimeEdit::init() +{ + d = new Q3DateTimeEditPrivate(); + de = new Q3DateEdit(this, "qt_datetime_dateedit"); + te = new Q3TimeEdit(this, "qt_datetime_timeedit"); + d->adv = false; + connect(de, SIGNAL(valueChanged(QDate)), this, SLOT(newValue(QDate))); + connect(te, SIGNAL(valueChanged(QTime)), this, SLOT(newValue(QTime))); + setFocusProxy(de); + setSizePolicy(QSizePolicy::Minimum, QSizePolicy::Fixed); +} + +/*! \reimp + */ + +QSize Q3DateTimeEdit::sizeHint() const +{ + ensurePolished(); + QSize dsh = de->sizeHint(); + QSize tsh = te->sizeHint(); + return QSize(dsh.width() + tsh.width(), + qMax(dsh.height(), tsh.height())); +} + +/*! + \property Q3DateTimeEdit::dateTime + \brief the editor's datetime value + + The datetime edit's datetime which may be an invalid datetime. +*/ + +void Q3DateTimeEdit::setDateTime(const QDateTime & dt) +{ + if (dt.isValid()) { + de->setDate(dt.date()); + te->setTime(dt.time()); + emit valueChanged(dt); + } +} + +QDateTime Q3DateTimeEdit::dateTime() const +{ + return QDateTime(de->date(), te->time()); +} + +/*! + \fn void Q3DateTimeEdit::valueChanged(const QDateTime& datetime) + + This signal is emitted every time the date or time changes. The \a + datetime argument is the new datetime. +*/ + + +/*! \internal + + Re-emits the value \a d. + */ + +void Q3DateTimeEdit::newValue(const QDate&) +{ + QDateTime dt = dateTime(); + emit valueChanged(dt); +} + +/*! \internal + \overload + Re-emits the value \a t. + */ + +void Q3DateTimeEdit::newValue(const QTime&) +{ + QDateTime dt = dateTime(); + emit valueChanged(dt); +} + + +/*! + Sets the auto advance property of the editor to \a advance. If set + to true, the editor will automatically advance focus to the next + date or time section if the user has completed a section. +*/ + +void Q3DateTimeEdit::setAutoAdvance(bool advance) +{ + de->setAutoAdvance(advance); + te->setAutoAdvance(advance); +} + +/*! + Returns true if auto-advance is enabled, otherwise returns false. + + \sa setAutoAdvance() +*/ + +bool Q3DateTimeEdit::autoAdvance() const +{ + return de->autoAdvance(); +} + +/*! + \fn Q3DateEdit* Q3DateTimeEdit::dateEdit() + + Returns the internal widget used for editing the date part of the + datetime. +*/ + +/*! + \fn Q3TimeEdit* Q3DateTimeEdit::timeEdit() + + Returns the internal widget used for editing the time part of the + datetime. +*/ + +QT_END_NAMESPACE + +#include "q3datetimeedit.moc" + +#endif |