qdatetimeedit.h 8.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234
  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2016 The Qt Company Ltd.
  4. ** Contact: https://www.qt.io/licensing/
  5. **
  6. ** This file is part of the QtWidgets module of the Qt Toolkit.
  7. **
  8. ** $QT_BEGIN_LICENSE:LGPL$
  9. ** Commercial License Usage
  10. ** Licensees holding valid commercial Qt licenses may use this file in
  11. ** accordance with the commercial license agreement provided with the
  12. ** Software or, alternatively, in accordance with the terms contained in
  13. ** a written agreement between you and The Qt Company. For licensing terms
  14. ** and conditions see https://www.qt.io/terms-conditions. For further
  15. ** information use the contact form at https://www.qt.io/contact-us.
  16. **
  17. ** GNU Lesser General Public License Usage
  18. ** Alternatively, this file may be used under the terms of the GNU Lesser
  19. ** General Public License version 3 as published by the Free Software
  20. ** Foundation and appearing in the file LICENSE.LGPL3 included in the
  21. ** packaging of this file. Please review the following information to
  22. ** ensure the GNU Lesser General Public License version 3 requirements
  23. ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
  24. **
  25. ** GNU General Public License Usage
  26. ** Alternatively, this file may be used under the terms of the GNU
  27. ** General Public License version 2.0 or (at your option) the GNU General
  28. ** Public license version 3 or any later version approved by the KDE Free
  29. ** Qt Foundation. The licenses are as published by the Free Software
  30. ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
  31. ** included in the packaging of this file. Please review the following
  32. ** information to ensure the GNU General Public License requirements will
  33. ** be met: https://www.gnu.org/licenses/gpl-2.0.html and
  34. ** https://www.gnu.org/licenses/gpl-3.0.html.
  35. **
  36. ** $QT_END_LICENSE$
  37. **
  38. ****************************************************************************/
  39. #ifndef QDATETIMEEDIT_H
  40. #define QDATETIMEEDIT_H
  41. #include <QtCore/qdatetime.h>
  42. #include <QtCore/qvariant.h>
  43. #include <QtWidgets/qabstractspinbox.h>
  44. QT_BEGIN_NAMESPACE
  45. #ifndef QT_NO_DATETIMEEDIT
  46. class QDateTimeEditPrivate;
  47. class QStyleOptionSpinBox;
  48. class QCalendarWidget;
  49. class Q_WIDGETS_EXPORT QDateTimeEdit : public QAbstractSpinBox
  50. {
  51. Q_OBJECT
  52. Q_FLAGS(Sections)
  53. Q_PROPERTY(QDateTime dateTime READ dateTime WRITE setDateTime NOTIFY dateTimeChanged USER true)
  54. Q_PROPERTY(QDate date READ date WRITE setDate NOTIFY dateChanged)
  55. Q_PROPERTY(QTime time READ time WRITE setTime NOTIFY timeChanged)
  56. Q_PROPERTY(QDateTime maximumDateTime READ maximumDateTime WRITE setMaximumDateTime RESET clearMaximumDateTime)
  57. Q_PROPERTY(QDateTime minimumDateTime READ minimumDateTime WRITE setMinimumDateTime RESET clearMinimumDateTime)
  58. Q_PROPERTY(QDate maximumDate READ maximumDate WRITE setMaximumDate RESET clearMaximumDate)
  59. Q_PROPERTY(QDate minimumDate READ minimumDate WRITE setMinimumDate RESET clearMinimumDate)
  60. Q_PROPERTY(QTime maximumTime READ maximumTime WRITE setMaximumTime RESET clearMaximumTime)
  61. Q_PROPERTY(QTime minimumTime READ minimumTime WRITE setMinimumTime RESET clearMinimumTime)
  62. Q_PROPERTY(Section currentSection READ currentSection WRITE setCurrentSection)
  63. Q_PROPERTY(Sections displayedSections READ displayedSections)
  64. Q_PROPERTY(QString displayFormat READ displayFormat WRITE setDisplayFormat)
  65. Q_PROPERTY(bool calendarPopup READ calendarPopup WRITE setCalendarPopup)
  66. Q_PROPERTY(int currentSectionIndex READ currentSectionIndex WRITE setCurrentSectionIndex)
  67. Q_PROPERTY(int sectionCount READ sectionCount)
  68. Q_PROPERTY(Qt::TimeSpec timeSpec READ timeSpec WRITE setTimeSpec)
  69. public:
  70. enum Section { // a sub-type of QDateTimeParser's like-named enum.
  71. NoSection = 0x0000,
  72. AmPmSection = 0x0001,
  73. MSecSection = 0x0002,
  74. SecondSection = 0x0004,
  75. MinuteSection = 0x0008,
  76. HourSection = 0x0010,
  77. DaySection = 0x0100,
  78. MonthSection = 0x0200,
  79. YearSection = 0x0400,
  80. TimeSections_Mask = AmPmSection|MSecSection|SecondSection|MinuteSection|HourSection,
  81. DateSections_Mask = DaySection|MonthSection|YearSection
  82. };
  83. Q_ENUM(Section)
  84. Q_DECLARE_FLAGS(Sections, Section)
  85. explicit QDateTimeEdit(QWidget *parent = Q_NULLPTR);
  86. explicit QDateTimeEdit(const QDateTime &dt, QWidget *parent = Q_NULLPTR);
  87. explicit QDateTimeEdit(const QDate &d, QWidget *parent = Q_NULLPTR);
  88. explicit QDateTimeEdit(const QTime &t, QWidget *parent = Q_NULLPTR);
  89. ~QDateTimeEdit();
  90. QDateTime dateTime() const;
  91. QDate date() const;
  92. QTime time() const;
  93. QDateTime minimumDateTime() const;
  94. void clearMinimumDateTime();
  95. void setMinimumDateTime(const QDateTime &dt);
  96. QDateTime maximumDateTime() const;
  97. void clearMaximumDateTime();
  98. void setMaximumDateTime(const QDateTime &dt);
  99. void setDateTimeRange(const QDateTime &min, const QDateTime &max);
  100. QDate minimumDate() const;
  101. void setMinimumDate(const QDate &min);
  102. void clearMinimumDate();
  103. QDate maximumDate() const;
  104. void setMaximumDate(const QDate &max);
  105. void clearMaximumDate();
  106. void setDateRange(const QDate &min, const QDate &max);
  107. QTime minimumTime() const;
  108. void setMinimumTime(const QTime &min);
  109. void clearMinimumTime();
  110. QTime maximumTime() const;
  111. void setMaximumTime(const QTime &max);
  112. void clearMaximumTime();
  113. void setTimeRange(const QTime &min, const QTime &max);
  114. Sections displayedSections() const;
  115. Section currentSection() const;
  116. Section sectionAt(int index) const;
  117. void setCurrentSection(Section section);
  118. int currentSectionIndex() const;
  119. void setCurrentSectionIndex(int index);
  120. QCalendarWidget *calendarWidget() const;
  121. void setCalendarWidget(QCalendarWidget *calendarWidget);
  122. int sectionCount() const;
  123. void setSelectedSection(Section section);
  124. QString sectionText(Section section) const;
  125. QString displayFormat() const;
  126. void setDisplayFormat(const QString &format);
  127. bool calendarPopup() const;
  128. void setCalendarPopup(bool enable);
  129. Qt::TimeSpec timeSpec() const;
  130. void setTimeSpec(Qt::TimeSpec spec);
  131. QSize sizeHint() const;
  132. virtual void clear();
  133. virtual void stepBy(int steps);
  134. bool event(QEvent *event);
  135. Q_SIGNALS:
  136. void dateTimeChanged(const QDateTime &dateTime);
  137. void timeChanged(const QTime &time);
  138. void dateChanged(const QDate &date);
  139. public Q_SLOTS:
  140. void setDateTime(const QDateTime &dateTime);
  141. void setDate(const QDate &date);
  142. void setTime(const QTime &time);
  143. protected:
  144. virtual void keyPressEvent(QKeyEvent *event);
  145. #ifndef QT_NO_WHEELEVENT
  146. virtual void wheelEvent(QWheelEvent *event);
  147. #endif
  148. virtual void focusInEvent(QFocusEvent *event);
  149. virtual bool focusNextPrevChild(bool next);
  150. virtual QValidator::State validate(QString &input, int &pos) const;
  151. virtual void fixup(QString &input) const;
  152. virtual QDateTime dateTimeFromText(const QString &text) const;
  153. virtual QString textFromDateTime(const QDateTime &dt) const;
  154. virtual StepEnabled stepEnabled() const;
  155. virtual void mousePressEvent(QMouseEvent *event);
  156. virtual void paintEvent(QPaintEvent *event);
  157. void initStyleOption(QStyleOptionSpinBox *option) const;
  158. QDateTimeEdit(const QVariant &val, QVariant::Type parserType, QWidget *parent = Q_NULLPTR);
  159. private:
  160. Q_DECLARE_PRIVATE(QDateTimeEdit)
  161. Q_DISABLE_COPY(QDateTimeEdit)
  162. Q_PRIVATE_SLOT(d_func(), void _q_resetButton())
  163. };
  164. class Q_WIDGETS_EXPORT QTimeEdit : public QDateTimeEdit
  165. {
  166. Q_OBJECT
  167. Q_PROPERTY(QTime time READ time WRITE setTime NOTIFY userTimeChanged USER true)
  168. public:
  169. explicit QTimeEdit(QWidget *parent = Q_NULLPTR);
  170. explicit QTimeEdit(const QTime &time, QWidget *parent = Q_NULLPTR);
  171. ~QTimeEdit();
  172. Q_SIGNALS:
  173. void userTimeChanged(const QTime &time);
  174. };
  175. class Q_WIDGETS_EXPORT QDateEdit : public QDateTimeEdit
  176. {
  177. Q_OBJECT
  178. Q_PROPERTY(QDate date READ date WRITE setDate NOTIFY userDateChanged USER true)
  179. public:
  180. explicit QDateEdit(QWidget *parent = Q_NULLPTR);
  181. explicit QDateEdit(const QDate &date, QWidget *parent = Q_NULLPTR);
  182. ~QDateEdit();
  183. Q_SIGNALS:
  184. void userDateChanged(const QDate &date);
  185. };
  186. Q_DECLARE_OPERATORS_FOR_FLAGS(QDateTimeEdit::Sections)
  187. #endif // QT_NO_DATETIMEEDIT
  188. QT_END_NAMESPACE
  189. #endif // QDATETIMEEDIT_H