QDateTimeEdit Class
Die Klasse „QDateTimeEdit“ stellt ein Widget zur Bearbeitung von Datums- und Zeitangaben bereit. Mehr...
| Header: | #include <QDateTimeEdit> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QAbstractSpinBox |
| Vererbt an: |
Öffentliche Typen
| enum | Section { NoSection, AmPmSection, MSecSection, SecondSection, MinuteSection, …, YearSection } |
| flags | Sections |
Eigenschaften
|
|
Öffentliche Funktionen
| QDateTimeEdit(QWidget *parent = nullptr) | |
| QDateTimeEdit(QDate date, QWidget *parent = nullptr) | |
| QDateTimeEdit(QTime time, QWidget *parent = nullptr) | |
| QDateTimeEdit(const QDateTime &datetime, QWidget *parent = nullptr) | |
| virtual | ~QDateTimeEdit() |
| QCalendar | calendar() const |
| bool | calendarPopup() const |
| QCalendarWidget * | calendarWidget() const |
| void | clearMaximumDate() |
| void | clearMaximumDateTime() |
| void | clearMaximumTime() |
| void | clearMinimumDate() |
| void | clearMinimumDateTime() |
| void | clearMinimumTime() |
| QDateTimeEdit::Section | currentSection() const |
| int | currentSectionIndex() const |
| QDate | date() const |
| QDateTime | dateTime() const |
| QString | displayFormat() const |
| QDateTimeEdit::Sections | displayedSections() const |
| QDate | maximumDate() const |
| QDateTime | maximumDateTime() const |
| QTime | maximumTime() const |
| QDate | minimumDate() const |
| QDateTime | minimumDateTime() const |
| QTime | minimumTime() const |
| QDateTimeEdit::Section | sectionAt(int index) const |
| int | sectionCount() const |
| QString | sectionText(QDateTimeEdit::Section section) const |
| void | setCalendar(QCalendar calendar) |
| void | setCalendarPopup(bool enable) |
| void | setCalendarWidget(QCalendarWidget *calendarWidget) |
| void | setCurrentSection(QDateTimeEdit::Section section) |
| void | setCurrentSectionIndex(int index) |
| void | setDateRange(QDate min, QDate max) |
| void | setDateTimeRange(const QDateTime &min, const QDateTime &max) |
| void | setDisplayFormat(const QString &format) |
| void | setMaximumDate(QDate max) |
| void | setMaximumDateTime(const QDateTime &dt) |
| void | setMaximumTime(QTime max) |
| void | setMinimumDate(QDate min) |
| void | setMinimumDateTime(const QDateTime &dt) |
| void | setMinimumTime(QTime min) |
| void | setSelectedSection(QDateTimeEdit::Section section) |
| void | setTimeRange(QTime min, QTime max) |
| void | setTimeZone(const QTimeZone &zone) |
| QTime | time() const |
| QTimeZone | timeZone() const |
Neu implementierte öffentliche Funktionen
| virtual void | clear() override |
| virtual bool | event(QEvent *event) override |
| virtual QSize | sizeHint() const override |
| virtual void | stepBy(int steps) override |
Öffentliche Slots
| void | setDate(QDate date) |
| void | setDateTime(const QDateTime &dateTime) |
| void | setTime(QTime time) |
Signale
| void | dateChanged(QDate date) |
| void | dateTimeChanged(const QDateTime &datetime) |
| void | timeChanged(QTime time) |
Geschützte Funktionen
| virtual QDateTime | dateTimeFromText(const QString &text) const |
| virtual QString | textFromDateTime(const QDateTime &dateTime) const |
Neu implementierte geschützte Funktionen
| virtual void | fixup(QString &input) const override |
| virtual void | focusInEvent(QFocusEvent *event) override |
| virtual bool | focusNextPrevChild(bool next) override |
| virtual void | initStyleOption(QStyleOptionSpinBox *option) const override |
| virtual void | keyPressEvent(QKeyEvent *event) override |
| virtual void | mousePressEvent(QMouseEvent *event) override |
| virtual void | paintEvent(QPaintEvent *event) override |
| virtual QAbstractSpinBox::StepEnabled | stepEnabled() const override |
| virtual QValidator::State | validate(QString &text, int &pos) const override |
| virtual void | wheelEvent(QWheelEvent *event) override |
Ausführliche Beschreibung
Mit QDateTimeEdit kann der Benutzer Datumsangaben bearbeiten, indem er die Tastatur oder die Pfeiltasten verwendet, um Datums- und Zeitwerte zu erhöhen oder zu verringern. Mit den Pfeiltasten kann innerhalb des QDateTimeEdit-Feldes von Abschnitt zu Abschnitt gewechselt werden. Datums- und Zeitangaben werden entsprechend dem festgelegten Format angezeigt; siehe setDisplayFormat().
QDateTimeEdit *dateEdit = new QDateTimeEdit(QDate::currentDate());
dateEdit->setMinimumDate(QDate::currentDate().addDays(-365));
dateEdit->setMaximumDate(QDate::currentDate().addDays(365));
dateEdit->setDisplayFormat("yyyy.MM.dd");Hier haben wir ein neues QDateTimeEdit-Objekt erstellt, das mit dem heutigen Datum initialisiert wurde, und den gültigen Datumsbereich auf das heutige Datum plus oder minus 365 Tage beschränkt. Wir haben die Reihenfolge auf Monat, Tag, Jahr festgelegt.
Der Bereich gültiger Werte für ein `QDateTimeEdit`-Objekt wird durch die Eigenschaften ` minimumDateTime`, ` maximumDateTime` sowie deren jeweilige Datums- und Zeitkomponenten gesteuert. Standardmäßig ist jedes Datum und jede Uhrzeit vom Beginn des Jahres 100 n. Chr. bis zum Ende des Jahres 9999 n. Chr. gültig.
Verwendung eines Popup-Kalender-Widgets
QDateTimeEdit kann so konfiguriert werden, dass ein „ QCalendarWidget “ zur Auswahl von Datumsangaben verwendet werden kann. Dies wird durch das Setzen der Eigenschaft „ calendarPopup “ aktiviert. Zusätzlich können Sie ein benutzerdefiniertes Kalender-Widget als Popup-Kalender bereitstellen, indem Sie die Funktion „ setCalendarWidget()“ aufrufen. Das vorhandene Kalender-Widget kann mit „ calendarWidget()“ abgerufen werden.
Tastatur-Tracking
Wenn „ keyboard tracking “ aktiviert ist (Standardeinstellung), löst jeder Tastenanschlag bei der Bearbeitung eines Feldes Signale für Wertänderungen aus.
Wenn der zulässige Bereich für „ range “ schmaler ist als ein Zeitintervall, dessen Ende er überspannt, verhindert die Tastaturüberwachung, dass der Benutzer das Datum oder die Uhrzeit so bearbeitet, dass er auf den späteren Teil des Intervalls zugreift. Beispiel: Bei einem Bereich vom 29.04.2020 bis zum 02.05.2020 und einem Anfangsdatum am 30.04.2020 kann der Benutzer weder den Monat (der 30. Mai liegt außerhalb des Bereichs) noch den Tag (der 2. April liegt außerhalb des Bereichs) ändern.
Wenn die Tastaturüberwachung deaktiviert ist, werden Änderungen erst signalisiert, wenn der Fokus das Textfeld verlässt, nachdem der Inhalt durch Bearbeitungen geändert wurde. Dies ermöglicht es dem Benutzer, über ein ungültiges Datums- und Zeitformat zu einem gültigen zu gelangen.
Siehe auch QDateEdit, QTimeEdit, QDate und QTime.
Dokumentation zum Mitgliedstyp
enum QDateTimeEdit::Section
flags QDateTimeEdit::Sections
| Konstante | Wert |
|---|---|
QDateTimeEdit::NoSection | 0x0000 |
QDateTimeEdit::AmPmSection | 0x0001 |
QDateTimeEdit::MSecSection | 0x0002 |
QDateTimeEdit::SecondSection | 0x0004 |
QDateTimeEdit::MinuteSection | 0x0008 |
QDateTimeEdit::HourSection | 0x0010 |
QDateTimeEdit::DaySection | 0x0100 |
QDateTimeEdit::MonthSection | 0x0200 |
QDateTimeEdit::YearSection | 0x0400 |
Der Typ „Sections“ ist ein typedef für QFlags<Section>. Er speichert eine ODER-Kombination von „Section“-Werten.
Dokumentation zur Eigenschaft
calendarPopup : bool
Diese Eigenschaft gibt den aktuellen Anzeigemodus des Kalender-Popups an.
Das Kalender-Popup wird beim Klicken auf die Pfeiltaste angezeigt. Diese Eigenschaft ist nur gültig, wenn ein gültiges Datumsanzeigeformat vorhanden ist.
Zugriffsfunktionen:
| bool | calendarPopup() const |
| void | setCalendarPopup(bool enable) |
Siehe auch „ setDisplayFormat()“.
currentSection : Section
Diese Eigenschaft enthält den aktuellen Abschnitt des Spinbox-Feldes.
Zugriffsfunktionen:
| QDateTimeEdit::Section | currentSection() const |
| void | setCurrentSection(QDateTimeEdit::Section section) |
currentSectionIndex : int
Diese Eigenschaft enthält den aktuellen Abschnittsindex der Spinbox.
Wenn das Format „yyyy/MM/dd“ lautet, der „displayText“ den Wert „2001/05/21“ hat und die „cursorPosition“ 5 beträgt, gibt „currentSectionIndex“ den Wert 1 zurück. Liegt die „cursorPosition“ bei 3, beträgt der Wert von „currentSectionIndex“ 0 usw.
Zugriffsfunktionen:
| int | currentSectionIndex() const |
| void | setCurrentSectionIndex(int index) |
Siehe auch „ setCurrentSection()“ und „ currentSection()“.
date : QDate
Diese Eigenschaft enthält den Wert „ QDate “, der im Widget festgelegt ist.
Standardmäßig enthält diese Eigenschaft ein Datum, das sich auf den 1. Januar 2000 bezieht.
Zugriffsfunktionen:
| QDate | date() const |
| void | setDate(QDate date) |
Notifier-Signal:
| void | dateChanged(QDate date) |
Siehe auch „ time “ und „ dateTime “.
dateTime : QDateTime
Diese Eigenschaft enthält den Wert „ QDateTime “, der in der Eigenschaft „ QDateTimeEdit “ festgelegt ist.
Beim Setzen dieser Eigenschaft wird der neue „ QDateTime “ in das Zeitsystem des „ QDateTimeEdit “ konvertiert, das somit unverändert bleibt.
Standardmäßig ist diese Eigenschaft auf den Beginn des Jahres 2000 n. Chr. gesetzt. Sie kann nur auf einen gültigen Wert für „ QDateTime “ gesetzt werden. Wenn diese Eigenschaft durch einen Vorgang einen ungültigen Datums- und Zeitwert annimmt, wird sie auf den Wert der Eigenschaft „ minimumDateTime “ zurückgesetzt.
Wenn die „ QDateTimeEdit “ keine Datumsfelder enthält, wird durch das Setzen dieser Eigenschaft der Datumsbereich des Widgets so festgelegt, dass er am Datum des neuen Werts dieser Eigenschaft beginnt und endet.
Zugriffsfunktionen:
| QDateTime | dateTime() const |
| void | setDateTime(const QDateTime &dateTime) |
Benachrichtigungssignal:
| void | dateTimeChanged(const QDateTime &datetime) |
Siehe auch „ date“ , „ time “, „ minimumDateTime “, „ maximumDateTime “ und „ timeZone “.
displayFormat : QString
Diese Eigenschaft enthält das Format, das zur Anzeige von Uhrzeit und Datum im Datums- und Uhrzeit-Bearbeitungsfeld verwendet wird.
Dieses Format wird unter QDateTime::toString() und QDateTime::fromString() beschrieben.
Beispiele für Formatzeichenfolgen (unter der Annahme, dass das Datum der 2. Juli 1969 ist):
| Format | Ergebnis |
|---|---|
| dd.MM.yyyy | 02.07.1969 |
| MMM d jj | 2. Juli 69 |
| MMMM d jj | 2. Juli 69 |
Beachten Sie, dass bei Angabe eines zweistelligen Jahres dieses als das Jahrhundert interpretiert wird, in dem die Datums- und Zeitbearbeitung initialisiert wurde. Das Standardjahrhundert ist das 21. (2000–2099).
Wenn Sie ein ungültiges Format angeben, wird das Format nicht festgelegt.
Zugriffsfunktionen:
| QString | displayFormat() const |
| void | setDisplayFormat(const QString &format) |
Siehe auch „ QDateTime::toString()“ und „ displayedSections()“.
[read-only] displayedSections : Sections
Diese Eigenschaft enthält die derzeit angezeigten Felder des Datums- und Zeitfelds.
Gibt einen Bit-Satz der angezeigten Abschnitte für dieses Format zurück.
Zugriffsfunktionen:
| QDateTimeEdit::Sections | displayedSections() const |
Siehe auch „ setDisplayFormat()“ und „ displayFormat()“.
maximumDate : QDate
Diese Eigenschaft enthält das maximale Datum des Datums- und Zeitfelds.
Durch Ändern dieser Eigenschaft wird das Datum der Eigenschaft „ maximumDateTime “ aktualisiert, während die Eigenschaft „ maximumTime “ beibehalten wird. Beim Festlegen dieser Eigenschaft wird die Eigenschaft „ minimumDate “ bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt. In diesem Fall wird auch die Eigenschaft „ minimumTime “ angepasst, sofern sie größer ist als die Eigenschaft „ maximumTime “. Andernfalls bleiben bei Änderungen an dieser Eigenschaft die Werte der Eigenschaft „ minimumDateTime “ erhalten.
Diese Eigenschaft kann nur auf ein gültiges „ QDate “-Objekt gesetzt werden, das ein Datum beschreibt, an dem die aktuelle Eigenschaft „ maximumTime “ ein gültiges „ QDateTime “-Objekt ergibt. Das späteste Datum, das „setMaximumDate()“ akzeptiert, ist das Ende des Jahres 9999 n. Chr. Dies ist der Standardwert für diese Eigenschaft. Dieser Standardwert kann mit „ clearMaximumDateTime()“ wiederhergestellt werden.
Zugriffsfunktionen:
| QDate | maximumDate() const |
| void | setMaximumDate(QDate max) |
| void | clearMaximumDate() |
Siehe auch „ minimumDate“ , „ maximumTime “, „ maximumDateTime “, „ setDateRange()“, „ QDate::isValid()“ und „ Keyboard Tracking “.
maximumDateTime : QDateTime
Diese Eigenschaft enthält den maximalen Datums- und Zeitwert des Datums- und Zeitfelds.
Durch das Ändern dieser Eigenschaft werden die Eigenschaften „ maximumDate “ und „ maximumTime “ implizit auf den Datums- bzw. Zeitanteil dieser Eigenschaft aktualisiert. Beim Festlegen dieser Eigenschaft wird die Eigenschaft „ minimumDateTime “ bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Andernfalls bleibt die Eigenschaft „ minimumDateTime “ beim Ändern dieser Eigenschaft unverändert.
Diese Eigenschaft kann nur auf einen gültigen Wert für „ QDateTime “ gesetzt werden. Das späteste Datum und die späteste Uhrzeit, die von „setMaximumDateTime()“ akzeptiert werden, entsprechen dem Ende des Jahres 9999 n. Chr. Dies ist der Standardwert für diese Eigenschaft. Dieser Standardwert kann mit „clearMaximumDateTime()“ wiederhergestellt werden.
Zugriffsfunktionen:
| QDateTime | maximumDateTime() const |
| void | setMaximumDateTime(const QDateTime &dt) |
| void | clearMaximumDateTime() |
Siehe auch „ minimumDateTime“ , „ maximumTime “, „ maximumDate()“, „ setDateTimeRange()“, „ QDateTime::isValid()“ und „ Keyboard Tracking “.
maximumTime : QTime
Diese Eigenschaft enthält die maximale Zeit für die Bearbeitung von Datum und Uhrzeit.
Durch Ändern dieser Eigenschaft wird die Zeit der Eigenschaft „ maximumDateTime “ aktualisiert, während die Eigenschaften „ minimumDate “ und „ maximumDate “ beibehalten werden. Wenn diese Datums-Eigenschaften übereinstimmen, wird beim Festlegen dieser Eigenschaft die Eigenschaft „ minimumTime “ bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Andernfalls bleibt beim Ändern dieser Eigenschaft die Eigenschaft „ minimumDateTime “ erhalten.
Diese Eigenschaft kann auf einen beliebigen gültigen Wert von ` QTime ` gesetzt werden. Standardmäßig enthält diese Eigenschaft eine Zeit von 23:59:59 und 999 Millisekunden. Dieser Standardwert kann mit `clearMaximumTime()` wiederhergestellt werden.
Zugriffsfunktionen:
| QTime | maximumTime() const |
| void | setMaximumTime(QTime max) |
| void | clearMaximumTime() |
Siehe auch „ minimumTime“ , „ maximumDate “, „ maximumDateTime “, „ setTimeRange()“, „ QTime::isValid()“ und „ Keyboard Tracking “.
minimumDate : QDate
Diese Eigenschaft enthält das früheste Datum des Datums- und Zeitfelds.
Durch Ändern dieser Eigenschaft wird das Datum der Eigenschaft „ minimumDateTime “ aktualisiert, während die Eigenschaft „ minimumTime “ beibehalten wird. Beim Festlegen dieser Eigenschaft wird die Eigenschaft „ maximumDate “ bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt. In diesem Fall wird auch die Eigenschaft „ maximumTime “ angepasst, sofern ihr Wert kleiner ist als der Wert der Eigenschaft „ minimumTime “. Andernfalls bleibt die Eigenschaft „ maximumDateTime “ bei Änderungen an dieser Eigenschaft erhalten.
Diese Eigenschaft kann nur auf ein gültiges „ QDate “-Objekt gesetzt werden, das ein Datum beschreibt, an dem die aktuelle Eigenschaft „ minimumTime “ ein gültiges „ QDateTime “-Objekt ergibt. Das früheste Datum, das „setMinimumDate()“ akzeptiert, ist der Beginn des Jahres 100 n. Chr. Der Standardwert für diese Eigenschaft ist der 14. September 1752 n. Chr. Dieser Standardwert kann mit „ clearMinimumDateTime()“ wiederhergestellt werden.
Zugriffsfunktionen:
| QDate | minimumDate() const |
| void | setMinimumDate(QDate min) |
| void | clearMinimumDate() |
Siehe auch „ maximumDate“ , „ minimumTime “, „ minimumDateTime “, „ setDateRange()“, „ QDate::isValid()“ und „ Keyboard Tracking “.
minimumDateTime : QDateTime
Diese Eigenschaft enthält den frühesten Datums- und Zeitwert der Datums- und Zeitbearbeitung.
Durch das Ändern dieser Eigenschaft werden die Eigenschaften „ minimumDate “ und „ minimumTime “ implizit auf den Datums- bzw. Zeitanteil dieser Eigenschaft aktualisiert. Beim Festlegen dieser Eigenschaft wird der „ maximumDateTime “ bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Andernfalls bleibt die Eigenschaft „ maximumDateTime “ beim Ändern dieser Eigenschaft unverändert.
Diese Eigenschaft kann nur auf einen gültigen Wert von „ QDateTime “ gesetzt werden. Das früheste Datum und die früheste Uhrzeit, die von `setMinimumDateTime()` akzeptiert werden, sind der Beginn des Jahres 100 n. Chr. Der Standardwert der Eigenschaft ist der Beginn des 14. September 1752 n. Chr. Dieser Standardwert kann mit `clearMinimumDateTime()` wiederhergestellt werden.
Zugriffsfunktionen:
| QDateTime | minimumDateTime() const |
| void | setMinimumDateTime(const QDateTime &dt) |
| void | clearMinimumDateTime() |
Siehe auch „ maximumDateTime“ , „ minimumTime “, „ minimumDate “, „ setDateTimeRange()“, „ QDateTime::isValid()“ und „ Keyboard Tracking “.
minimumTime : QTime
Diese Eigenschaft enthält die Mindestdauer des Datums- und Zeitfelds.
Durch Ändern dieser Eigenschaft wird die Zeit der Eigenschaft „ minimumDateTime “ aktualisiert, während die Eigenschaften „ minimumDate “ und „ maximumDate “ beibehalten werden. Wenn diese Datums-Eigenschaften übereinstimmen, wird beim Festlegen dieser Eigenschaft die Eigenschaft „ maximumTime “ gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Andernfalls bleibt beim Ändern dieser Eigenschaft die Eigenschaft „ maximumDateTime “ erhalten.
Diese Eigenschaft kann auf jeden gültigen Wert von „ QTime “ gesetzt werden. Standardmäßig enthält diese Eigenschaft eine Zeit von 00:00:00 und 0 Millisekunden. Dieser Standardwert kann mit „clearMinimumTime()“ wiederhergestellt werden.
Zugriffsfunktionen:
| QTime | minimumTime() const |
| void | setMinimumTime(QTime min) |
| void | clearMinimumTime() |
Siehe auch „ maximumTime“ , „ minimumDate “, „ minimumDateTime “, „ setTimeRange()“, „ QTime::isValid()“ und „ Keyboard Tracking “.
[read-only] sectionCount : int
Diese Eigenschaft gibt die Anzahl der angezeigten Abschnitte an. Wenn das Format „yyyy/yy/yyyy“ lautet, gibt „sectionCount“ den Wert 3 zurück
Zugriffsfunktionen:
| int | sectionCount() const |
time : QTime
Diese Eigenschaft enthält die im Widget festgelegte Zeitangabe „ QTime “.
Standardmäßig enthält diese Eigenschaft einen Zeitpunkt von 00:00:00 und 0 Millisekunden.
Zugriffsfunktionen:
| QTime | time() const |
| void | setTime(QTime time) |
Notifier-Signal:
| void | timeChanged(QTime time) |
Siehe auch „ date “ und „ dateTime “.
[since 6.7] timeZone : QTimeZone
Diese Eigenschaft enthält die derzeit vom Datums- und Uhrzeit-Bearbeitungs-Widget verwendete Zeitzone
Wenn das verwendete Datums- und Zeitformat eine Zeitzonenangabe enthält – d. h. einen Formatbezeichner wie „ t “, „ tt “, „ ttt “ oder „ tttt “ –, wird die Eingabe des Benutzers bei jeder Auswertung in diese Zeitzone umgewandelt, wobei eine eventuell vom Benutzer angegebene Zeitzone außer Kraft gesetzt wird.
Diese Aufzählung wurde in Qt 6.7 eingeführt.
Zugriffsfunktionen:
| QTimeZone | timeZone() const |
| void | setTimeZone(const QTimeZone &zone) |
Siehe auch QDateTimeEdit::displayFormat.
Dokumentation zu den Mitgliedsfunktionen
[explicit] QDateTimeEdit::QDateTimeEdit(QWidget *parent = nullptr)
Erstellt einen leeren Datums- und Zeit-Editor mit einem „ parent “.
[explicit] QDateTimeEdit::QDateTimeEdit(QDate date, QWidget *parent = nullptr)
Erstellt einen leeren Datums- und Zeit-Editor mit dem Wert „ parent “. Der Wert wird auf „ date “ gesetzt.
[explicit] QDateTimeEdit::QDateTimeEdit(QTime time, QWidget *parent = nullptr)
Erstellt einen leeren Datums- und Zeit-Editor mit dem Wert „ parent “. Der Wert wird auf „ time “ gesetzt.
[explicit] QDateTimeEdit::QDateTimeEdit(const QDateTime &datetime, QWidget *parent = nullptr)
Erstellt einen leeren Datums- und Zeit-Editor mit dem Wert „ parent “. Der Wert wird auf „ datetime “ gesetzt.
[virtual noexcept] QDateTimeEdit::~QDateTimeEdit()
Destruktor.
QCalendar QDateTimeEdit::calendar() const
Geben Sie das von diesem Widget verwendete Kalendersystem an.
Siehe auch setCalendar().
QCalendarWidget *QDateTimeEdit::calendarWidget() const
Gibt das Kalender-Widget für den Editor zurück, wenn „ calendarPopup “ auf „true“ gesetzt ist und (sections() & DateSections_Mask) != 0 ist.
Diese Funktion erstellt ein Kalender-Widget und gibt es zurück, falls noch keines festgelegt wurde.
Siehe auch ` setCalendarWidget()`.
[override virtual] void QDateTimeEdit::clear()
Implementiert: QAbstractSpinBox::clear().
QDate QDateTimeEdit::date() const
Gibt das Datum aus, das in das Datums- und Zeitfeld eingegeben wurde.
Hinweis: Getter -Funktion für die Eigenschaft „date“.
Siehe auch „ setDate()“.
[signal] void QDateTimeEdit::dateChanged(QDate date)
Dieses Signal wird immer dann ausgelöst, wenn das Datum geändert wird. Das neue Datum wird in „ date “ übergeben.
Hinweis: Notifier -Signal für die Eigenschaft „ date “.
Siehe auch „ Keyboard Tracking “.
[signal] void QDateTimeEdit::dateTimeChanged(const QDateTime &datetime)
Dieses Signal wird immer dann ausgelöst, wenn das Datum oder die Uhrzeit geändert wird. Das neue Datum und die neue Uhrzeit werden in „ datetime “ übergeben.
Hinweis: Notifier -Signal für die Eigenschaft ` dateTime`.
Siehe auch „ Keyboard Tracking “.
[virtual protected] QDateTime QDateTimeEdit::dateTimeFromText(const QString &text) const
Gibt ein passendes Datums- und Zeitformat für das angegebene „ text “ zurück.
Diese virtuelle Funktion wird vom Datums- und Zeit-Eingabefeld verwendet, wann immer es vom Benutzer eingegebenen Text als Wert interpretieren muss.
Siehe auch „ textFromDateTime()“ und „ validate()“.
[override virtual] bool QDateTimeEdit::event(QEvent *event)
Umsetzt: QAbstractSpinBox::event(QEvent *event).
[override virtual protected] void QDateTimeEdit::fixup(QString &input) const
Implementiert neu: ` QAbstractSpinBox::fixup` (QString &input) const.
[override virtual protected] void QDateTimeEdit::focusInEvent(QFocusEvent *event)
Implementiert: ` QAbstractSpinBox::focusInEvent(QFocusEvent *event)`.
[override virtual protected] bool QDateTimeEdit::focusNextPrevChild(bool next)
Implementiert: ` QWidget::focusNextPrevChild` (bool next).
[override virtual protected] void QDateTimeEdit::initStyleOption(QStyleOptionSpinBox *option) const
Umsetzt: ` QAbstractSpinBox::initStyleOption(QStyleOptionSpinBox *option) const`.
Initialisiert ` option ` mit den Werten aus diesem `QDataTimeEdit`. Diese Methode ist für Unterklassen nützlich, wenn sie ein ` QStyleOptionSpinBox` benötigen, aber nicht alle Informationen selbst eingeben möchten.
Siehe auch QStyleOption::initFrom().
[override virtual protected] void QDateTimeEdit::keyPressEvent(QKeyEvent *event)
Implementiert: ` QAbstractSpinBox::keyPressEvent(QKeyEvent *event)`.
[override virtual protected] void QDateTimeEdit::mousePressEvent(QMouseEvent *event)
Implementiert: QAbstractSpinBox::mousePressEvent(QMouseEvent *event).
[override virtual protected] void QDateTimeEdit::paintEvent(QPaintEvent *event)
Umsetzt: ` QAbstractSpinBox::paintEvent` (`QPaintEvent *event`).
QDateTimeEdit::Section QDateTimeEdit::sectionAt(int index) const
Gibt den Abschnitt unter index zurück.
Wenn das Format „yyyy/MM/dd“ lautet, gibt sectionAt(0) „ YearSection “ zurück, sectionAt(1) gibt „ MonthSection “ zurück und sectionAt(2) gibt „ YearSection “ zurück,
QString QDateTimeEdit::sectionText(QDateTimeEdit::Section section) const
Gibt den Text aus der angegebenen „ section “ zurück.
Siehe auch currentSection().
void QDateTimeEdit::setCalendar(QCalendar calendar)
Legen Sie „ calendar “ als das von diesem Widget zu verwendende Kalendersystem fest.
Das Widget kann jedes unterstützte Kalendersystem verwenden. Standardmäßig wird der Gregorianische Kalender verwendet.
Siehe auch calendar().
void QDateTimeEdit::setCalendarWidget(QCalendarWidget *calendarWidget)
Legt das angegebene „ calendarWidget “ als das für das Kalender-Popup zu verwendende Widget fest. Der Editor übernimmt nicht automatisch die Verantwortung für das Kalender-Widget.
Hinweis: „ calendarPopup “ muss auf „true“ gesetzt werden, bevor das Kalender-Widget festgelegt wird.
Siehe auch „ calendarWidget()“ und „ calendarPopup “.
void QDateTimeEdit::setDateRange(QDate min, QDate max)
Legen Sie den Bereich der zulässigen Datumsangaben für die Datums- und Zeitbearbeitung fest.
Diese Komfortfunktion legt die Eigenschaften „ minimumDate “ und „ maximumDate “ fest.
setDateRange(min, max);entspricht:
setMinimumDate(min);
setMaximumDate(max);Wenn entweder „ min “ oder „ max “ ungültig ist, führt diese Funktion keine Aktion aus. Diese Funktion behält die Eigenschaft „ minimumTime “ bei. Wenn „ max “ kleiner ist als „ min “, soll die neue Eigenschaft „ maximumDateTime “ der neuen Eigenschaft „ minimumDateTime “ entsprechen. Wenn „ max “ gleich „ min “ ist und die Eigenschaft „ maximumTime “ kleiner war als die Eigenschaft „ minimumTime “, wird die Eigenschaft „ maximumTime “ auf die Eigenschaft „ minimumTime “ gesetzt. Andernfalls bleibt die Eigenschaft „ maximumTime “ erhalten.
Wenn der Bereich enger ist als ein Zeitintervall, dessen Ende er umfasst – beispielsweise eine Woche, die über das Monatsende hinausgeht –, können Benutzer das Datum nur auf ein Datum im späteren Teil des Bereichs ändern, wenn die Tastaturverfolgung deaktiviert ist.
Siehe auch „ minimumDate“ , „ maximumDate “, „ setDateTimeRange()“, „ QDate::isValid()“ und „ Keyboard Tracking “.
void QDateTimeEdit::setDateTimeRange(const QDateTime &min, const QDateTime &max)
Legen Sie den Bereich der zulässigen Datums- und Zeitangaben für die Bearbeitung von Datums- und Zeitangaben fest.
Diese Komfortfunktion legt die Eigenschaften „ minimumDateTime “ und „ maximumDateTime “ fest.
setDateTimeRange(min, max);entspricht:
setMinimumDateTime(min);
setMaximumDateTime(max);Wenn entweder „ min “ oder „ max “ ungültig ist, führt diese Funktion keine Aktion aus. Wenn „ max “ kleiner ist als „ min “, wird „ min “ auch als „ max “ verwendet.
Ist der Bereich enger als ein Zeitintervall, dessen Ende er umfasst – beispielsweise eine Woche, die über das Monatsende hinausreicht –, können Benutzer das Datum und die Uhrzeit nur auf einen Wert im späteren Teil des Bereichs bearbeiten, wenn die Tastaturverfolgung deaktiviert ist.
Siehe auch minimumDateTime, maximumDateTime, setDateRange(), setTimeRange(), QDateTime::isValid() und Keyboard Tracking.
void QDateTimeEdit::setSelectedSection(QDateTimeEdit::Section section)
Wählt „ section “ aus. Wenn „ section “ in den aktuell angezeigten Abschnitten nicht vorhanden ist, führt diese Funktion keine Aktion aus. Wenn „ section “ „ NoSection “ ist, hebt diese Funktion die Auswahl des gesamten Textes im Editor auf. Andernfalls verschiebt diese Funktion den Cursor und den aktuellen Abschnitt in den ausgewählten Abschnitt.
Siehe auch „ currentSection()“.
void QDateTimeEdit::setTimeRange(QTime min, QTime max)
Legen Sie den Bereich der zulässigen Zeiten für die Bearbeitung von Datum und Uhrzeit fest.
Diese Komfortfunktion legt die Eigenschaften „ minimumTime “ und „ maximumTime “ fest.
Beachten Sie, dass diese Eigenschaften den Wert der Datums- und Zeitbearbeitung lediglich auf die Werte „ minimumDate “ bzw. „ maximumDate “ beschränken. Wenn diese Datums-Eigenschaften nicht übereinstimmen, sind Zeiten nach „ max “ an Tagen vor „ maximumDate “ zulässig, und Zeiten vor „ min “ sind an Tagen nach „ minimumDate “ zulässig.
setTimeRange(min, max);entspricht:
setMinimumTime(min);
setMaximumTime(max);Wenn entweder min oder max ungültig ist, führt diese Funktion keine Aktion aus. Diese Funktion behält die Eigenschaften minimumDate und maximumDate bei. Wenn diese Eigenschaften übereinstimmen und max kleiner als min ist, wird min als max verwendet.
Ist der Bereich enger als ein Zeitintervall, dessen Ende er umfasst – zum Beispiel das Intervall von zehn bis eine Stunde bis zehn nach derselben Stunde –, können Benutzer die Zeit nur auf einen Wert im späteren Teil des Bereichs bearbeiten, wenn die Tastaturverfolgung deaktiviert ist.
Siehe auch minimumTime, maximumTime, setDateTimeRange(), QTime::isValid() und Keyboard Tracking.
[override virtual] QSize QDateTimeEdit::sizeHint() const
Implementiert: ` QAbstractSpinBox::sizeHint()` const.
[override virtual] void QDateTimeEdit::stepBy(int steps)
Implementiert: QAbstractSpinBox::stepBy(int steps).
[override virtual protected] QAbstractSpinBox::StepEnabled QDateTimeEdit::stepEnabled() const
Implementiert: ` QAbstractSpinBox::stepEnabled()` const.
[virtual protected] QString QDateTimeEdit::textFromDateTime(const QDateTime &dateTime) const
Diese virtuelle Funktion wird vom Datums- und Zeit-Editfeld verwendet, wann immer es „ dateTime “ anzeigen muss.
Wenn Sie diese Funktion neu implementieren, müssen Sie möglicherweise auch ` validate()` neu implementieren.
Siehe auch „ dateTimeFromText()“ und „ validate()“.
QTime QDateTimeEdit::time() const
Gibt die Uhrzeit des Datums-/Zeitfelds zurück.
Hinweis: Getter -Funktion für die Eigenschaft „time“.
Siehe auch „ setTime()“.
[signal] void QDateTimeEdit::timeChanged(QTime time)
Dieses Signal wird immer dann ausgelöst, wenn die Uhrzeit geändert wird. Die neue Uhrzeit wird in „ time “ übergeben.
Hinweis: Notifier -Signal für die Eigenschaft ` time`.
Siehe auch ` Keyboard Tracking`.
[override virtual protected] QValidator::State QDateTimeEdit::validate(QString &text, int &pos) const
Implementiert erneut: ` QAbstractSpinBox::validate(QString &input, int &pos) const`.
[override virtual protected] void QDateTimeEdit::wheelEvent(QWheelEvent *event)
Implementiert neu: QAbstractSpinBox::wheelEvent(QWheelEvent *event).
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
