QDateTimeEdit Class
Die Klasse QDateTimeEdit bietet ein Widget zum Bearbeiten von Daten und Zeiten. Mehr...
| Kopfzeile: | #include <QDateTimeEdit> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Vererbt: | QAbstractSpinBox |
| Vererbt von: |
Ö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 | setTimeSpec(Qt::TimeSpec spec) |
| void | setTimeZone(const QTimeZone &zone) |
| QTime | time() const |
| Qt::TimeSpec | timeSpec() const |
| QTimeZone | timeZone() const |
Reimplementierte ö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 |
Reimplementierte 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 |
Detaillierte Beschreibung
QDateTimeEdit ermöglicht es dem Benutzer, Datumsangaben zu bearbeiten, indem er die Tastatur oder die Pfeiltasten verwendet, um Datums- und Zeitwerte zu erhöhen oder zu verringern. Die Pfeiltasten können verwendet werden, um innerhalb des Feldes QDateTimeEdit von Abschnitt zu Abschnitt zu wechseln. Datums- und Zeitangaben werden in Übereinstimmung mit dem eingestellten 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 heute plus oder minus 365 Tage eingeschränkt. Wir haben die Reihenfolge auf Monat, Tag, Jahr festgelegt.
Der Bereich gültiger Werte für ein QDateTimeEdit wird durch die Eigenschaften minimumDateTime, maximumDateTime und ihre jeweiligen Datums- und Zeitkomponenten gesteuert. Standardmäßig sind alle Datums- und Zeitangaben zwischen dem Beginn von 100 CE und dem Ende von 9999 CE gültig.
Verwendung eines Pop-up-Kalender-Widgets
QDateTimeEdit kann so konfiguriert werden, dass ein QCalendarWidget zur Auswahl von Daten verwendet werden kann. Dies wird durch die Einstellung der Eigenschaft calendarPopup ermöglicht. Zusätzlich können Sie ein benutzerdefiniertes Kalender-Widget für die Verwendung als Pop-up-Kalender bereitstellen, indem Sie die Funktion setCalendarWidget() aufrufen. Das vorhandene Kalender-Widget kann mit calendarWidget() abgerufen werden.
Tastaturverfolgung
Wenn keyboard tracking aktiviert ist (Standardeinstellung), löst jeder Tastendruck beim Bearbeiten eines Feldes Signale für Wertänderungen aus.
Wenn der zulässige Bereich range kleiner ist als ein Zeitintervall, dessen Ende er überspannt, verhindert die Tastaturverfolgung, dass der Benutzer das Datum oder die Uhrzeit bearbeitet, um auf den späteren Teil des Intervalls zuzugreifen. Bei einem Bereich vom 29.04.2020 bis zum 02.05.2020 und einem Anfangsdatum vom 30.04.2020 kann der Benutzer beispielsweise 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 Tastaturverfolgung deaktiviert ist, werden Änderungen nur gemeldet, wenn der Fokus das Textfeld verlässt, nachdem der Inhalt geändert wurde. Dies ermöglicht es dem Benutzer, über eine ungültige Datumszeit zu editieren, um eine gültige zu erreichen.
Siehe auch QDateEdit, QTimeEdit, QDate, und QTime.
Member Type Dokumentation
enum QDateTimeEdit::Abschnitt
flags QDateTimeEdit::Abschnitte
| 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 der Eigenschaft
calendarPopup : bool
Diese Eigenschaft enthält den aktuellen Modus für die Anzeige des Kalender-Pop-ups.
Das Kalender-Pop-up wird angezeigt, wenn Sie auf die Pfeilschaltfläche klicken. 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 der Spinbox.
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', der displayText '2001/05/21' und die cursorPosition 5 ist, gibt currentSectionIndex 1 zurück. Wenn die CursorPosition 3 ist, ist currentSectionIndex 0, usw.
Zugriffsfunktionen:
| int | currentSectionIndex() const |
| void | setCurrentSectionIndex(int index) |
Siehe auch setCurrentSection() und currentSection().
date : QDate
Diese Eigenschaft enthält die QDate, die im Widget eingestellt 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) |
Benachrichtigungssignal:
| void | dateChanged(QDate date) |
dateTime : QDateTime
Diese Eigenschaft enthält die QDateTime, die in der QDateTimeEdit eingestellt ist.
Beim Einstellen dieser Eigenschaft wird die neue QDateTime in das Zeitsystem der QDateTimeEdit umgewandelt, das somit unverändert bleibt.
Standardmäßig ist diese Eigenschaft auf den Beginn des Jahres 2000 CE eingestellt. Sie kann nur auf einen gültigen Wert von QDateTime gesetzt werden. Wenn ein Vorgang dazu führt, dass diese Eigenschaft einen ungültigen Datums-/Zeitwert hat, wird sie auf den Wert der Eigenschaft minimumDateTime zurückgesetzt.
Wenn QDateTimeEdit keine Datumsfelder hat, wird durch das Setzen dieser Eigenschaft der Datumsbereich des Widgets so eingestellt, dass er mit dem 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 für die Anzeige der Uhrzeit/Datum der Datums-/Zeitbearbeitung verwendet wird.
Dieses Format ist in QDateTime::toString() und QDateTime::fromString() beschrieben.
Beispiel für Formatstrings (unter der Annahme, dass das Datum der 2. Juli 1969 ist):
| Format | Ergebnis |
|---|---|
| tt.MM.jjjj | 02.07.1969 |
| MMM.jjj | 2. Juli 1969 |
| MMMM t jjj | 2. Juli 69 |
Beachten Sie, dass die Angabe einer zweistelligen Jahreszahl so interpretiert wird, dass sie in dem Jahrhundert liegt, 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 gesetzt.
Zugriffsfunktionen:
| QString | displayFormat() const |
| void | setDisplayFormat(const QString &format) |
Siehe auch QDateTime::toString() und displayedSections().
[read-only] displayedSections : const Sections
Diese Eigenschaft enthält die aktuell angezeigten Felder der Datums-Zeit-Bearbeitung.
Gibt eine Bitmenge 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 der Datums-Zeit-Bearbeitung.
Durch die Änderung dieser Eigenschaft wird das Datum der Eigenschaft maximumDateTime aktualisiert, während die Eigenschaft maximumTime erhalten bleibt. Beim Einstellen dieser Eigenschaft wird die Eigenschaft minimumDate gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt. In diesem Fall wird auch die Eigenschaft minimumTime angepasst, wenn sie größer ist als die Eigenschaft maximumTime. Andernfalls bleibt bei Änderungen dieser Eigenschaft die Eigenschaft minimumDateTime erhalten.
Diese Eigenschaft kann nur auf ein gültiges QDate Objekt gesetzt werden, das ein Datum beschreibt, an dem die aktuelle maximumTime Eigenschaft ein gültiges QDateTime Objekt ergibt. Das späteste Datum, das setMaximumDate() akzeptiert, ist das Ende von 9999 CE. Dies ist die Voreinstellung für diese Eigenschaft. Diese Vorgabe 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 die maximale Datumszeit der Datums-Zeit-Bearbeitung.
Bei einer Änderung dieser Eigenschaft werden die Eigenschaften maximumDate und maximumTime implizit auf den Datums- bzw. Zeitteil dieser Eigenschaft aktualisiert. Beim Festlegen dieser Eigenschaft wird minimumDateTime bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Andernfalls bleibt bei der Änderung dieser Eigenschaft die Eigenschaft minimumDateTime erhalten.
Diese Eigenschaft kann nur auf einen gültigen QDateTime Wert gesetzt werden. Die späteste Datumszeit, die setMaximumDateTime() akzeptiert, ist das Ende von 9999 CE. Dies ist die Standardeinstellung für diese Eigenschaft. Diese Vorgabe 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 der Datumszeit.
Eine Änderung dieser Eigenschaft aktualisiert die Zeit der Eigenschaft maximumDateTime, während die Eigenschaften minimumDate und maximumDate erhalten bleiben. Wenn diese Datumseigenschaften übereinstimmen, wird beim Setzen dieser Eigenschaft die Eigenschaft minimumTime gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Andernfalls bleibt bei der Änderung dieser Eigenschaft die Eigenschaft minimumDateTime erhalten.
Diese Eigenschaft kann auf jeden gültigen QTime Wert eingestellt werden. Standardmäßig enthält diese Eigenschaft eine Zeit von 23:59:59 und 999 Millisekunden. Diese Voreinstellung 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 Mindestdatum der Datumszeitbearbeitung.
Durch die Änderung dieser Eigenschaft wird das Datum der Eigenschaft minimumDateTime aktualisiert, während die Eigenschaft minimumTime erhalten bleibt. Beim Einstellen dieser Eigenschaft wird die Eigenschaft maximumDate gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt. In diesem Fall wird auch die Eigenschaft maximumTime angepasst, wenn sie kleiner ist als die Eigenschaft minimumTime. Andernfalls bleibt bei Änderungen dieser Eigenschaft die Eigenschaft maximumDateTime erhalten.
Diese Eigenschaft kann nur auf ein gültiges QDate Objekt gesetzt werden, das ein Datum beschreibt, an dem die aktuelle minimumTime Eigenschaft ein gültiges QDateTime Objekt ergibt. Das früheste Datum, das setMinimumDate() akzeptiert, ist der Beginn von 100 CE. Der Standardwert für diese Eigenschaft ist der 14. September 1752 CE. Diese Vorgabe 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 die minimale Datumszeit der Datums-Zeit-Bearbeitung.
Bei einer Änderung dieser Eigenschaft werden die Eigenschaften minimumDate und minimumTime implizit auf den Datums- bzw. Zeitteil dieser Eigenschaft aktualisiert. Beim Festlegen dieser Eigenschaft wird maximumDateTime bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Andernfalls bleibt bei der Änderung dieser Eigenschaft die Eigenschaft maximumDateTime erhalten.
Diese Eigenschaft kann nur auf einen gültigen QDateTime Wert gesetzt werden. Die früheste Datumszeit, die setMinimumDateTime() akzeptiert, ist der Beginn von 100 CE. Der Standardwert der Eigenschaft ist der Beginn des 14. September 1752 CE. Diese Vorgabe 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 Mindestzeit der Datumszeitbearbeitung.
Eine Änderung dieser Eigenschaft aktualisiert die Zeit der Eigenschaft minimumDateTime, während die Eigenschaften minimumDate und maximumDate erhalten bleiben. Wenn diese Datumseigenschaften übereinstimmen, wird beim Setzen dieser Eigenschaft die Eigenschaft maximumTime gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Andernfalls bleibt bei der Änderung dieser Eigenschaft die Eigenschaft maximumDateTime erhalten.
Diese Eigenschaft kann auf jeden gültigen QTime Wert eingestellt werden. Standardmäßig enthält diese Eigenschaft eine Zeit von 00:00:00 und 0 Millisekunden. Diese Voreinstellung 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 : const int
Diese Eigenschaft enthält die Anzahl der angezeigten Abschnitte. Wenn das Format 'jjjj/jjj/jjjj' ist, gibt sectionCount 3 zurück.
Zugriffsfunktionen:
| int | sectionCount() const |
time : QTime
Diese Eigenschaft enthält die QTime, die im Widget eingestellt ist.
Standardmäßig enthält diese Eigenschaft eine Zeit von 00:00:00 und 0 Millisekunden.
Zugriffsfunktionen:
| QTime | time() const |
| void | setTime(QTime time) |
Benachrichtigungssignal:
| void | timeChanged(QTime time) |
[until 6.10] timeSpec : Qt::TimeSpec
Diese Eigenschaft soll in Version 6.10 veraltet sein.
Verwenden Sie stattdessen QDateTimeEdit::timeZone.
Diese Eigenschaft enthält die aktuelle Timespec, die von der Datums- und Zeitbearbeitung verwendet wird.
Seit Qt 6.7 ist dies ein indirekter Accessor für die timeZone Eigenschaft.
Zugriffsfunktionen:
| Qt::TimeSpec | timeSpec() const |
| void | setTimeSpec(Qt::TimeSpec spec) |
Siehe auch QDateTimeEdit::timeZone.
[since 6.7] timeZone : QTimeZone
Diese Eigenschaft enthält die aktuelle Zeitzone, die vom Datetime-Editing-Widget verwendet wird
Wenn das verwendete Datetime-Format einen Zeitzonen-Indikator enthält - d.h. einen t, tt, ttt oder tttt Format-Spezifikator - wird die Benutzereingabe in dieser Zeitzone wiedergegeben, wenn sie analysiert wird, und überschreibt jede Zeitzone, die der Benutzer angegeben hat.
Diese Eigenschaft wurde in Qt 6.7 eingeführt.
Zugriffsfunktionen:
| QTimeZone | timeZone() const |
| void | setTimeZone(const QTimeZone &zone) |
Siehe auch QDateTimeEdit::displayFormat.
Dokumentation der Mitgliedsfunktionen
[explicit] QDateTimeEdit::QDateTimeEdit(QWidget *parent = nullptr)
Konstruiert einen leeren Datums-Zeit-Editor mit einem parent.
[explicit] QDateTimeEdit::QDateTimeEdit(QDate date, QWidget *parent = nullptr)
Konstruiert einen leeren Datums-Zeit-Editor mit einem parent. Der Wert wird auf date gesetzt.
[explicit] QDateTimeEdit::QDateTimeEdit(QTime time, QWidget *parent = nullptr)
Konstruiert einen leeren Datums-Zeit-Editor mit einem parent. Der Wert wird auf time gesetzt.
[explicit] QDateTimeEdit::QDateTimeEdit(const QDateTime &datetime, QWidget *parent = nullptr)
Konstruiert einen leeren Datums-Zeit-Editor mit einem parent. Der Wert wird auf datetime gesetzt.
[virtual noexcept] QDateTimeEdit::~QDateTimeEdit()
Zerstörer.
QCalendar QDateTimeEdit::calendar() const
Meldet das Kalendersystem, das von diesem Widget verwendet wird.
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.
Diese Funktion erstellt ein Kalender-Widget und gibt es zurück, wenn keines gesetzt wurde.
Siehe auch setCalendarWidget().
[override virtual] void QDateTimeEdit::clear()
Reimplements: QAbstractSpinBox::clear().
QDate QDateTimeEdit::date() const
Gibt das Datum der Datums-Zeit-Bearbeitung zurück.
Hinweis: Getter-Funktion für die Eigenschaft date.
Siehe auch setDate().
[signal] void QDateTimeEdit::dateChanged(QDate date)
Dieses Signal wird immer dann ausgegeben, wenn das Datum geändert wird. Das neue Datum wird in date übergeben.
Hinweis: Benachrichtigungssignal für die Eigenschaft date.
Siehe auch Keyboard Tracking.
[signal] void QDateTimeEdit::dateTimeChanged(const QDateTime &datetime)
Dieses Signal wird ausgegeben, wenn das Datum oder die Uhrzeit geändert wird. Das neue Datum und die Uhrzeit werden in datetime übergeben.
Hinweis: Benachrichtigungssignal für die Eigenschaft dateTime.
Siehe auch Keyboard Tracking.
[virtual protected] QDateTime QDateTimeEdit::dateTimeFromText(const QString &text) const
Gibt eine passende Datetime für die angegebene text zurück.
Diese virtuelle Funktion wird von datetime edit immer dann verwendet, wenn ein vom Benutzer eingegebener Text als Wert interpretiert werden soll.
Siehe auch textFromDateTime() und validate().
[override virtual] bool QDateTimeEdit::event(QEvent *event)
Reimplements: QAbstractSpinBox::event(QEvent *Event).
[override virtual protected] void QDateTimeEdit::fixup(QString &input) const
Reimplements: QAbstractSpinBox::fixup(QString &input) const.
[override virtual protected] void QDateTimeEdit::focusInEvent(QFocusEvent *event)
Reimplements: QAbstractSpinBox::focusInEvent(QFocusEvent *event).
[override virtual protected] bool QDateTimeEdit::focusNextPrevChild(bool next)
Reimplements: QWidget::focusNextPrevChild(bool next).
[override virtual protected] void QDateTimeEdit::initStyleOption(QStyleOptionSpinBox *option) const
Reimplements: QAbstractSpinBox::initStyleOption(QStyleOptionSpinBox *option) const.
Initialisiert option mit den Werten aus diesem QDataTimeEdit. Diese Methode ist nützlich für Unterklassen, die eine QStyleOptionSpinBox benötigen, aber nicht alle Informationen selbst eingeben wollen.
Siehe auch QStyleOption::initFrom().
[override virtual protected] void QDateTimeEdit::keyPressEvent(QKeyEvent *event)
Reimplements: QAbstractSpinBox::keyPressEvent(QKeyEvent *event).
[override virtual protected] void QDateTimeEdit::mousePressEvent(QMouseEvent *event)
Reimplements: QAbstractSpinBox::mousePressEvent(QMouseEvent *event).
[override virtual protected] void QDateTimeEdit::paintEvent(QPaintEvent *event)
Reimplements: QAbstractSpinBox::paintEvent(QPaintEvent *event).
QDateTimeEdit::Section QDateTimeEdit::sectionAt(int index) const
Gibt den Abschnitt unter index zurück.
Wenn das Format "yyyy/MM/dd" ist, 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 dem angegebenen section zurück.
Siehe auch currentSection().
void QDateTimeEdit::setCalendar(QCalendar calendar)
Legen Sie calendar als das Kalendersystem fest, das von diesem Widget verwendet werden soll.
Das Widget kann jedes unterstützte Kalendersystem verwenden. Standardmäßig verwendet es den Gregorianischen Kalender.
Siehe auch calendar().
void QDateTimeEdit::setCalendarWidget(QCalendarWidget *calendarWidget)
Legt das angegebene calendarWidget als das für das Kalender-Pop-up zu verwendende Widget fest. Der Editor übernimmt nicht automatisch das Eigentum an dem Kalender-Widget.
Hinweis: calendarPopup muss auf true gesetzt werden, bevor das Kalender-Widget gesetzt wird.
Siehe auch calendarWidget() und calendarPopup.
void QDateTimeEdit::setDateRange(QDate min, QDate max)
Legt den Bereich der zulässigen Daten für die Bearbeitung des Datums und der Uhrzeit fest.
Diese Komfortfunktion setzt die Eigenschaften minimumDate und maximumDate.
setDateRange(min, max);ist analog zu:
setMinimumDate(min); setMaximumDate(max);
Wenn entweder min oder max ungültig ist, bewirkt diese Funktion nichts. Diese Funktion behält die Eigenschaft minimumTime bei. Wenn max kleiner als min ist, ist die neue Eigenschaft maximumDateTime die neue Eigenschaft minimumDateTime. 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 wird die Eigenschaft maximumTime beibehalten.
Wenn der Bereich kleiner ist als ein Zeitintervall, dessen Ende er umspannt, z. B. eine Woche, die das Ende eines Monats umspannt, können Benutzer das Datum nur dann 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)
Legt den Bereich der zulässigen Datumszeiten für die Datumszeitbearbeitung fest.
Diese Komfortfunktion setzt die Eigenschaften minimumDateTime und maximumDateTime.
setDateTimeRange(min, max);ist analog zu:
setMinimumDateTime(min); setMaximumDateTime(max);
Wenn entweder min oder max ungültig ist, tut diese Funktion nichts. Wenn max kleiner als min ist, wird min auch als max verwendet.
Wenn der Bereich kleiner ist als das Zeitintervall, dessen Ende er umspannt, z. B. eine Woche, die das Ende eines Monats umspannt, können die Benutzer die Datumszeit nur dann auf eine Zeit im späteren Teil des Bereichs ändern, 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, bewirkt diese Funktion nichts. Wenn section gleich NoSection ist, wird mit dieser Funktion der gesamte Text im Editor abgewählt. 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)
Legt den Bereich der zulässigen Zeiten für die Datums- und Zeitbearbeitung fest.
Diese Komfortfunktion setzt die Eigenschaften minimumTime und maximumTime.
Beachten Sie, dass diese nur den Wert der Datums-Zeit-Bearbeitung auf minimumDate bzw. maximumDate einschränken. Wenn diese Datumseigenschaften nicht übereinstimmen, sind Zeiten nach max an Daten vor maximumDate und Zeiten vor min an Daten nach minimumDate erlaubt.
setTimeRange(min, max);ist analog dazu:
setMinimumTime(min); setMaximumTime(max);
Wenn entweder min oder max ungültig ist, tut diese Funktion nichts. Diese Funktion bewahrt die Eigenschaften minimumDate und maximumDate. Wenn diese Eigenschaften übereinstimmen und max kleiner als min ist, wird min als max verwendet.
Wenn der Bereich kleiner ist als das Zeitintervall, dessen Ende er umspannt, z. B. das Intervall von zehn vor einer Stunde bis zehn nach derselben Stunde, können Benutzer die Zeit nur dann auf eine Zeit im späteren Teil des Bereichs ändern, wenn die Tastaturverfolgung deaktiviert ist.
Siehe auch minimumTime, maximumTime, setDateTimeRange(), QTime::isValid(), und Keyboard Tracking.
[override virtual] QSize QDateTimeEdit::sizeHint() const
Reimplements: QAbstractSpinBox::sizeHint() const.
[override virtual] void QDateTimeEdit::stepBy(int steps)
Reimplements: QAbstractSpinBox::stepBy(int steps).
[override virtual protected] QAbstractSpinBox::StepEnabled QDateTimeEdit::stepEnabled() const
Reimplements: QAbstractSpinBox::stepEnabled() const.
[virtual protected] QString QDateTimeEdit::textFromDateTime(const QDateTime &dateTime) const
Diese virtuelle Funktion wird von der Datums-Zeit-Bearbeitung verwendet, wenn sie 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
Liefert die Zeit des Datums Zeit bearbeiten.
Hinweis: Getter-Funktion für die Eigenschaft time.
Siehe auch setTime().
[signal] void QDateTimeEdit::timeChanged(QTime time)
Dieses Signal wird bei jeder Änderung der Uhrzeit ausgegeben. Die neue Zeit wird in time übergeben.
Hinweis: Benachrichtigungssignal für die Eigenschaft time.
Siehe auch Keyboard Tracking.
[override virtual protected] QValidator::State QDateTimeEdit::validate(QString &text, int &pos) const
Reimplements: QAbstractSpinBox::validate(QString &input, int &pos) const.
[override virtual protected] void QDateTimeEdit::wheelEvent(QWheelEvent *event)
Reimplements: QAbstractSpinBox::wheelEvent(QWheelEvent *event).
© 2025 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.
