2
Copyright 2011 John Layt <john@layt.net>
4
This library is free software; you can redistribute it and/or
5
modify it under the terms of the GNU Library General Public
6
License as published by the Free Software Foundation; either
7
version 2 of the License, or (at your option) any later version.
9
This library is distributed in the hope that it will be useful,
10
but WITHOUT ANY WARRANTY; without even the implied warranty of
11
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12
Library General Public License for more details.
14
You should have received a copy of the GNU Library General Public License
15
along with this library; see the file COPYING.LIB. If not, write to
16
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
17
Boston, MA 02110-1301, USA.
20
#include "kdatetimeedit.h"
22
#include <QtCore/QStringList>
23
#include <QtGui/QKeyEvent>
24
#include <QtGui/QMenu>
25
#include <QtGui/QLineEdit>
26
#include <QtGui/QWidgetAction>
29
#include "kdatetime.h"
30
#include "ksystemtimezone.h"
31
#include "kcalendarsystem.h"
32
#include "kcombobox.h"
33
#include "kdatepicker.h"
34
#include "kdatecombobox.h"
35
#include "kmessagebox.h"
37
#include "ui_kdatetimeedit.h"
39
class KDateTimeEditPrivate
42
KDateTimeEditPrivate(KDateTimeEdit *q);
43
virtual ~KDateTimeEditPrivate();
45
const KCalendarSystem *calendar() const;
47
KDateTime defaultMinDateTime();
48
KDateTime defaultMaxDateTime();
51
void initDateWidget();
52
void initTimeWidget();
53
void initCalendarWidget();
54
void updateCalendarWidget();
55
void initTimeSpecWidget();
56
void updateTimeSpecWidget();
61
void selectCalendar(int index);
62
void enterCalendar(KLocale::CalendarSystem calendarSystem);
63
void selectTimeZone(int index);
64
void enterTimeZone(const QString &zone);
66
KDateTimeEdit *const q;
68
KDateTimeEdit::Options m_options;
70
KDateTime m_minDateTime;
71
KDateTime m_maxDateTime;
75
QList<KLocale::CalendarSystem> m_calendarSystems;
76
KTimeZones::ZoneMap m_zones;
81
KDateTimeEditPrivate::KDateTimeEditPrivate(KDateTimeEdit *q)
84
m_options = KDateTimeEdit::ShowDate | KDateTimeEdit::EditDate | KDateTimeEdit::SelectDate |
85
KDateTimeEdit::ShowTime | KDateTimeEdit::EditTime | KDateTimeEdit::SelectTime |
86
KDateTimeEdit::DatePicker | KDateTimeEdit::DateKeywords;
87
m_dateTime = KDateTime::currentLocalDateTime();
88
m_dateTime.setTime(QTime(0, 0, 0));
89
m_calendarSystems = KCalendarSystem::calendarSystemsList();
90
m_zones = KSystemTimeZones::zones();
93
KDateTimeEditPrivate::~KDateTimeEditPrivate()
97
const KCalendarSystem *KDateTimeEditPrivate::calendar() const
99
return ui.m_dateCombo->calendar();
102
KDateTime KDateTimeEditPrivate::defaultMinDateTime()
104
return KDateTime(calendar()->earliestValidDate(), QTime(0, 0, 0, 0));
107
KDateTime KDateTimeEditPrivate::defaultMaxDateTime()
109
return KDateTime(calendar()->latestValidDate(), QTime(23, 59, 59, 999));
112
void KDateTimeEditPrivate::initWidgets()
116
initCalendarWidget();
117
initTimeSpecWidget();
120
void KDateTimeEditPrivate::initDateWidget()
122
ui.m_dateCombo->blockSignals(true);
123
ui.m_dateCombo->setVisible((m_options &KDateTimeEdit::ShowDate) == KDateTimeEdit::ShowDate);
124
KDateComboBox::Options options;
125
if ((m_options & KDateTimeEdit::EditDate) == KDateTimeEdit::EditDate) {
126
options = options | KDateComboBox::EditDate;
128
if ((m_options & KDateTimeEdit::SelectDate) == KDateTimeEdit::SelectDate) {
129
options = options | KDateComboBox::SelectDate;
131
if ((m_options & KDateTimeEdit::DatePicker) == KDateTimeEdit::DatePicker) {
132
options = options | KDateComboBox::DatePicker;
134
if ((m_options & KDateTimeEdit::DateKeywords) == KDateTimeEdit::DateKeywords) {
135
options = options | KDateComboBox::DateKeywords;
137
ui.m_dateCombo->setOptions(options);
138
ui.m_dateCombo->blockSignals(false);
141
void KDateTimeEditPrivate::initTimeWidget()
143
ui.m_timeCombo->blockSignals(true);
144
ui.m_timeCombo->setVisible((m_options &KDateTimeEdit::ShowDate) == KDateTimeEdit::ShowDate);
145
KTimeComboBox::Options options;
146
if ((m_options &KDateTimeEdit::EditTime) == KDateTimeEdit::EditTime) {
147
options = options | KTimeComboBox::EditTime;
149
if ((m_options &KDateTimeEdit::SelectTime) == KDateTimeEdit::SelectTime) {
150
options = options | KTimeComboBox::SelectTime;
152
if ((m_options &KDateTimeEdit::ForceTime) == KDateTimeEdit::ForceTime) {
153
options = options | KTimeComboBox::ForceTime;
155
ui.m_timeCombo->setOptions(options);
156
ui.m_timeCombo->blockSignals(false);
159
void KDateTimeEditPrivate::initCalendarWidget()
161
ui.m_calendarCombo->blockSignals(true);
162
ui.m_calendarCombo->clear();
163
foreach (KLocale::CalendarSystem calendar, m_calendarSystems) {
164
ui.m_calendarCombo->addItem(KCalendarSystem::calendarLabel(calendar), calendar);
166
ui.m_calendarCombo->setCurrentIndex(ui.m_calendarCombo->findData(ui.m_dateCombo->calendarSystem()));
167
ui.m_calendarCombo->setVisible((m_options &KDateTimeEdit::ShowCalendar) == KDateTimeEdit::ShowCalendar);
168
ui.m_calendarCombo->setEnabled((m_options &KDateTimeEdit::SelectCalendar) == KDateTimeEdit::SelectCalendar);
169
ui.m_calendarCombo->setEditable(false);
170
ui.m_calendarCombo->blockSignals(false);
173
void KDateTimeEditPrivate::updateCalendarWidget()
175
ui.m_calendarCombo->blockSignals(true);
176
ui.m_calendarCombo->setCurrentIndex(ui.m_calendarCombo->findData(ui.m_dateCombo->calendarSystem()));
177
ui.m_calendarCombo->blockSignals(false);
180
void KDateTimeEditPrivate::selectCalendar(int index)
182
enterCalendar((KLocale::CalendarSystem) ui.m_calendarCombo->itemData(index).toInt());
185
void KDateTimeEditPrivate::enterCalendar(KLocale::CalendarSystem calendarSystem)
187
q->setCalendarSystem(calendarSystem);
188
emit q->calendarEntered(ui.m_dateCombo->calendarSystem());
191
void KDateTimeEditPrivate::initTimeSpecWidget()
193
ui.m_timeSpecCombo->blockSignals(true);
194
ui.m_timeSpecCombo->clear();
195
ui.m_timeSpecCombo->addItem(i18nc("UTC time zone", "UTC"), "UTC");
196
ui.m_timeSpecCombo->addItem(i18nc("No specific time zone", "Floating"), "Floating");
197
QStringList keys = m_zones.keys();
198
QMap<QString, QString> names;
199
foreach (const QString &key, keys) {
200
names.insert(i18n(key.toUtf8()).replace('_', ' '), key);
202
QMapIterator<QString, QString> i(names);
203
while (i.hasNext()) {
205
ui.m_timeSpecCombo->addItem(i.key(), i.value());
207
ui.m_timeSpecCombo->setVisible((m_options &KDateTimeEdit::ShowTimeSpec) == KDateTimeEdit::ShowTimeSpec);
208
ui.m_timeSpecCombo->setEnabled((m_options &KDateTimeEdit::SelectTimeSpec) == KDateTimeEdit::SelectTimeSpec);
209
ui.m_timeSpecCombo->setEditable(false);
210
ui.m_timeSpecCombo->blockSignals(false);
213
void KDateTimeEditPrivate::updateTimeSpecWidget()
215
ui.m_timeSpecCombo->blockSignals(true);
216
ui.m_timeSpecCombo->blockSignals(false);
219
void KDateTimeEditPrivate::selectTimeZone(int index)
221
enterTimeZone(ui.m_timeCombo->itemData(index).toString());
224
void KDateTimeEditPrivate::enterTimeZone(const QString &zone)
226
q->setTimeSpec(m_zones.value(zone));
227
emit q->dateTimeEntered(m_dateTime);
228
emit q->timeSpecEntered(m_dateTime.timeSpec());
231
void KDateTimeEditPrivate::warnDateTime()
234
(m_options &KDateTimeEdit::WarnOnInvalid) == KDateTimeEdit::WarnOnInvalid) {
236
if (!m_dateTime.isValid()) {
237
//TODO Add missing string
238
//warnMsg = i18n("The date or time you entered is invalid");
239
} else if (m_dateTime < m_minDateTime) {
240
if (m_minWarnMsg.isEmpty()) {
241
//TODO Add datetime to string
242
//warnMsg = i18nc("@info", "Date and time cannot be earlier than %1", formatDate(m_minDate));
243
warnMsg = i18nc("@info", "The entered date and time is before the minimum allowed date and time.");
245
warnMsg = m_minWarnMsg;
246
//TODO localize properly
247
warnMsg.replace("%1", KGlobal::locale()->formatDateTime(m_minDateTime));
249
} else if (m_dateTime > m_maxDateTime) {
250
if (m_maxWarnMsg.isEmpty()) {
251
//TODO Add datetime to string
252
//warnMsg = i18nc("@info", "Date cannot be later than %1", formatDate(m_maxDate));
253
warnMsg = i18nc("@info", "The entered date and time is after the maximum allowed date and time.");
255
warnMsg = m_maxWarnMsg;
256
warnMsg.replace("%1", KGlobal::locale()->formatDateTime(m_maxDateTime));
259
KMessageBox::sorry(q, warnMsg);
264
KDateTimeEdit::KDateTimeEdit(QWidget *parent)
266
d(new KDateTimeEditPrivate(this))
268
KGlobal::locale()->insertCatalog("timezones4");
270
//Need to do the min/max defaults here and not in private init as need to wait for ui to init
271
//the KDateComboBox which holds the calendar object. Revisit this???
272
d->m_minDateTime = d->defaultMinDateTime();
273
d->m_maxDateTime = d->defaultMaxDateTime();
274
d->ui.m_calendarCombo->installEventFilter(this);
275
d->ui.m_dateCombo->installEventFilter(this);
276
d->ui.m_timeCombo->installEventFilter(this);
277
d->ui.m_timeSpecCombo->installEventFilter(this);
280
connect( d->ui.m_calendarCombo, SIGNAL(activated(int)),
281
this, SLOT(selectCalendar(int)));
282
connect( d->ui.m_timeSpecCombo, SIGNAL(activated(int)),
283
this, SLOT(selectTimeZone(int)));
286
KDateTimeEdit::~KDateTimeEdit()
291
KDateTime KDateTimeEdit::dateTime() const
293
return d->m_dateTime;
296
KLocale::CalendarSystem KDateTimeEdit::calendarSystem() const
298
return d-> ui.m_dateCombo->calendarSystem();
301
QDate KDateTimeEdit::date() const
303
return d->m_dateTime.date();
306
QTime KDateTimeEdit::time() const
308
return d->m_dateTime.time();
311
KDateTime::Spec KDateTimeEdit::timeSpec() const
313
return d->m_dateTime.timeSpec();
316
bool KDateTimeEdit::isValid() const
318
return d->m_dateTime.isValid() &&
319
d->m_dateTime >= d->m_minDateTime &&
320
d->m_dateTime <= d->m_maxDateTime;
323
bool KDateTimeEdit::isNull() const
325
return isNullDate() && isNullTime();
328
bool KDateTimeEdit::isValidDate() const
330
return d->ui.m_dateCombo->isValid();
333
bool KDateTimeEdit::isNullDate() const
335
return d->ui.m_dateCombo->isNull();
338
bool KDateTimeEdit::isValidTime() const
340
return d->ui.m_timeCombo->isValid();
343
bool KDateTimeEdit::isNullTime() const
345
return d->ui.m_timeCombo->isNull();
348
void KDateTimeEdit::setOptions(Options options)
350
if (options != d->m_options) {
351
d->m_options = options;
356
KDateTimeEdit::Options KDateTimeEdit::options() const
361
void KDateTimeEdit::setDateTime(const KDateTime &dateTime)
363
if (dateTime != d->m_dateTime) {
364
assignDateTime(dateTime);
365
emit dateTimeChanged(d->m_dateTime);
366
emit dateChanged(d->m_dateTime.date());
367
emit timeChanged(d->m_dateTime.time());
371
void KDateTimeEdit::assignDateTime(const KDateTime &dateTime)
373
d->m_dateTime = dateTime;
374
d->ui.m_dateCombo->setDate(dateTime.date());
375
d->ui.m_timeCombo->setTime(dateTime.time());
378
void KDateTimeEdit::setDate(const QDate &date)
380
if (date != d->m_dateTime.date()) {
382
emit dateTimeChanged(d->m_dateTime);
383
emit dateChanged(d->m_dateTime.date());
387
void KDateTimeEdit::assignDate(const QDate &date)
389
d->m_dateTime.setDate(date);
390
d->ui.m_dateCombo->setDate(date);
393
void KDateTimeEdit::setCalendarSystem(KLocale::CalendarSystem calendarSystem)
395
if (calendarSystem == d->ui.m_dateCombo->calendarSystem() ||
396
!d->m_calendarSystems.contains(calendarSystem)) {
400
assignCalendarSystem(calendarSystem);
401
emit calendarChanged(d->ui.m_dateCombo->calendarSystem());
404
void KDateTimeEdit::assignCalendarSystem(KLocale::CalendarSystem calendarSystem)
406
d->ui.m_dateCombo->setCalendarSystem(calendarSystem);
407
d->updateCalendarWidget();
410
void KDateTimeEdit::setCalendar(KCalendarSystem *calendar)
412
d->ui.m_dateCombo->setCalendar(calendar);
413
d->updateCalendarWidget();
416
void KDateTimeEdit::setTime(const QTime &time)
418
if (time != d->m_dateTime.time()) {
420
emit dateTimeChanged(d->m_dateTime);
421
emit timeChanged(d->m_dateTime.time());
425
void KDateTimeEdit::assignTime(const QTime &time)
427
d->m_dateTime.setTime(time);
428
d->ui.m_timeCombo->setTime(time);
431
void KDateTimeEdit::setTimeSpec(const KDateTime::Spec &spec)
433
if (spec == d->m_dateTime.timeSpec() || !spec.isValid()) {
437
assignTimeSpec(spec);
438
emit dateTimeChanged(d->m_dateTime);
439
emit timeSpecChanged(d->m_dateTime.timeSpec());
442
void KDateTimeEdit::assignTimeSpec(const KDateTime::Spec &spec)
444
d->m_dateTime.setTimeSpec(spec);
445
d->updateTimeSpecWidget();
448
void KDateTimeEdit::setMinimumDateTime(const KDateTime &minDateTime, const QString &minWarnMsg)
450
setDateTimeRange(minDateTime, maximumDateTime(), minWarnMsg, d->m_maxWarnMsg);
453
KDateTime KDateTimeEdit::minimumDateTime() const
455
return d->m_minDateTime;
458
void KDateTimeEdit::resetMinimumDateTime()
460
d->m_minDateTime = d->defaultMinDateTime();
463
void KDateTimeEdit::setMaximumDateTime(const KDateTime &maxDateTime, const QString &maxWarnMsg)
465
setDateTimeRange(minimumDateTime(), maxDateTime, d->m_minWarnMsg, maxWarnMsg);
468
KDateTime KDateTimeEdit::maximumDateTime() const
470
return d->m_maxDateTime;
473
void KDateTimeEdit::resetMaximumDateTime()
475
d->m_maxDateTime = d->defaultMaxDateTime();
478
void KDateTimeEdit::setDateTimeRange(const KDateTime &minDateTime,
479
const KDateTime &maxDateTime,
480
const QString &minErrorMsg,
481
const QString &maxErrorMsg)
483
if (minDateTime.isValid() &&
484
maxDateTime.isValid() &&
485
minDateTime <= maxDateTime &&
486
d->calendar()->isValid(minDateTime.date()) &&
487
d->calendar()->isValid(maxDateTime.date())) {
489
d->m_minDateTime = minDateTime;
490
d->m_minWarnMsg = minErrorMsg;
491
d->m_maxDateTime = maxDateTime;
492
d->m_maxWarnMsg = maxErrorMsg;
497
void KDateTimeEdit::resetDateTimeRange()
499
setDateTimeRange(d->defaultMinDateTime(), d->defaultMaxDateTime());
502
void KDateTimeEdit::setCalendarSystemsList(QList<KLocale::CalendarSystem> calendars)
504
if (calendars != d->m_calendarSystems) {
505
d->m_calendarSystems = calendars;
506
d->updateCalendarWidget();
510
QList<KLocale::CalendarSystem> KDateTimeEdit::calendarSystemsList() const
512
return d->m_calendarSystems;
515
void KDateTimeEdit::setDateDisplayFormat(KLocale::DateFormat format)
517
d->ui.m_dateCombo->setDisplayFormat(format);
520
KLocale::DateFormat KDateTimeEdit::dateDisplayFormat() const
522
return d->ui.m_dateCombo->displayFormat();
525
void KDateTimeEdit::setDateMap(QMap<QDate, QString> dateMap)
527
d->ui.m_dateCombo->setDateMap(dateMap);
530
QMap<QDate, QString> KDateTimeEdit::dateMap() const
532
return d->ui.m_dateCombo->dateMap();
535
void KDateTimeEdit::setTimeDisplayFormat(KLocale::TimeFormatOptions formatOptions)
537
d->ui.m_timeCombo->setDisplayFormat(formatOptions);
540
KLocale::TimeFormatOptions KDateTimeEdit::timeDisplayFormat() const
542
return d->ui.m_timeCombo->displayFormat();
545
void KDateTimeEdit::setTimeListInterval(int minutes)
547
d->ui.m_timeCombo->setTimeListInterval(minutes);
550
int KDateTimeEdit::timeListInterval() const
552
return d->ui.m_timeCombo->timeListInterval();
555
void KDateTimeEdit::setTimeList(QList<QTime> timeList,
556
const QString &minWarnMsg,
557
const QString &maxWarnMsg)
559
d->ui.m_timeCombo->setTimeList(timeList, minWarnMsg, maxWarnMsg);
562
QList<QTime> KDateTimeEdit::timeList() const
564
return d->ui.m_timeCombo->timeList();
567
void KDateTimeEdit::setTimeZones(const KTimeZones::ZoneMap &zones)
569
if (zones != d->m_zones) {
571
d->updateTimeSpecWidget();
575
KTimeZones::ZoneMap KDateTimeEdit::timeZones() const
580
bool KDateTimeEdit::eventFilter(QObject *object, QEvent *event)
582
return QWidget::eventFilter(object, event);
585
void KDateTimeEdit::focusInEvent(QFocusEvent *event)
587
QWidget::focusInEvent(event);
590
void KDateTimeEdit::focusOutEvent(QFocusEvent *event)
593
QWidget::focusOutEvent(event);
596
void KDateTimeEdit::resizeEvent(QResizeEvent *event)
598
QWidget::resizeEvent(event);
601
#include "kdatetimeedit.moc"