QDateTimeEdit Class

Member Function Documentation

QDateTimeEdit::QDateTimeEdit(const QTime &time, QWidget *parent = nullptr)

Constructs an empty date time editor with a parent. The value is set to time.

QDateTimeEdit::QDateTimeEdit(const QDate &date, QWidget *parent = nullptr)

Constructs an empty date time editor with a parent. The value is set to date.

QDateTimeEdit::QDateTimeEdit(const QDateTime &datetime, QWidget *parent = nullptr)

Constructs an empty date time editor with a parent. The value is set to datetime.

QDateTimeEdit::QDateTimeEdit(QWidget *parent = nullptr)

Constructs an empty date time editor with a parent.

[signal] void QDateTimeEdit::dateChanged(const QDate &date)

This signal is emitted whenever the date is changed. The new date is passed in date.

Note: Notifier signal for property date.

See also Keyboard Tracking.

[signal] void QDateTimeEdit::dateTimeChanged(const QDateTime &datetime)

This signal is emitted whenever the date or time is changed. The new date and time is passed in datetime.

Note: Notifier signal for property dateTime.

See also Keyboard Tracking.

[signal] void QDateTimeEdit::timeChanged(const QTime &time)

This signal is emitted whenever the time is changed. The new time is passed in time.

Note: Notifier signal for property time.

See also Keyboard Tracking.

[virtual] QDateTimeEdit::~QDateTimeEdit()

Destructor.

QCalendarWidget *QDateTimeEdit::calendarWidget() const

Returns the calendar widget for the editor if calendarPopup is set to true and (sections() & DateSections_Mask) != 0.

This function creates and returns a calendar widget if none has been set.

This function was introduced in Qt 4.4.

See also setCalendarWidget().

[override virtual] void QDateTimeEdit::clear()

Reimplements: QAbstractSpinBox::clear().

QDate QDateTimeEdit::date() const

Returns the date of the date time edit.

Note: Getter function for property date.

See also setDate().

[virtual protected] QDateTime QDateTimeEdit::dateTimeFromText(const QString &text) const

Returns an appropriate datetime for the given text.

This virtual function is used by the datetime edit whenever it needs to interpret text entered by the user as a value.

See also textFromDateTime() and 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).

[protected] void QDateTimeEdit::initStyleOption(QStyleOptionSpinBox *option) const

Initialize option with the values from this QDataTimeEdit. This method is useful for subclasses when they need a QStyleOptionSpinBox, but don't want to fill in all the information themselves.

See also 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

Returns the Section at index.

If the format is 'yyyy/MM/dd', sectionAt(0) returns YearSection, sectionAt(1) returns MonthSection, and sectionAt(2) returns YearSection,

This function was introduced in Qt 4.3.

QString QDateTimeEdit::sectionText(QDateTimeEdit::Section section) const

Returns the text from the given section.

See also currentSection().

void QDateTimeEdit::setCalendarWidget(QCalendarWidget *calendarWidget)

Sets the given calendarWidget as the widget to be used for the calendar pop-up. The editor does not automatically take ownership of the calendar widget.

This function was introduced in Qt 4.4.

See also calendarWidget() and calendarPopup.

void QDateTimeEdit::setDateRange(const QDate &min, const QDate &max)

Set the range of allowed dates for the date time edit.

This convenience function sets the minimumDate and maximumDate properties.

setDateRange(min, max);

is analogous to:

setMinimumDate(min);
setMaximumDate(max);

If either min or max is invalid, this function does nothing. This function preserves the minimumTime property. If max is less than min, the new maximumDateTime property shall be the new minimumDateTime property. If max is equal to min and the maximumTime property was less then the minimumTime property, the maximumTime property is set to the minimumTime property. Otherwise, this preserves the maximumTime property.

If the range is narrower then a time interval whose end it spans, for example a week that spans the end of a month, users can only edit the date to one in the later part of the range if keyboard-tracking is disabled.

See also minimumDate, maximumDate, setDateTimeRange(), QDate::isValid(), and Keyboard Tracking.

void QDateTimeEdit::setDateTimeRange(const QDateTime &min, const QDateTime &max)

Set the range of allowed date-times for the date time edit.

This convenience function sets the minimumDateTime and maximumDateTime properties.

setDateTimeRange(min, max);

is analogous to:

setMinimumDateTime(min);
setMaximumDateTime(max);

If either min or max is invalid, this function does nothing. If max is less than min, min is used also as max.

If the range is narrower then a time interval whose end it spans, for example a week that spans the end of a month, users can only edit the date-time to one in the later part of the range if keyboard-tracking is disabled.

This function was introduced in Qt 4.4.

See also minimumDateTime, maximumDateTime, setDateRange(), setTimeRange(), QDateTime::isValid(), and Keyboard Tracking.

void QDateTimeEdit::setSelectedSection(QDateTimeEdit::Section section)

Selects section. If section doesn't exist in the currently displayed sections, this function does nothing. If section is NoSection, this function will unselect all text in the editor. Otherwise, this function will move the cursor and the current section to the selected section.

This function was introduced in Qt 4.2.

See also currentSection().

void QDateTimeEdit::setTimeRange(const QTime &min, const QTime &max)

Set the range of allowed times for the date time edit.

This convenience function sets the minimumTime and maximumTime properties.

Note that these only constrain the date time edit's value on, respectively, the minimumDate and maximumDate. When these date properties do not coincide, times after max are allowed on dates before maximumDate and times before min are allowed on dates after minimumDate.

setTimeRange(min, max);

is analogous to:

setMinimumTime(min);
setMaximumTime(max);

If either min or max is invalid, this function does nothing. This function preserves the minimumDate and maximumDate properties. If those properties coincide and max is less than min, min is used as max.

If the range is narrower then a time interval whose end it spans, for example the interval from ten to an hour to ten past the same hour, users can only edit the time to one in the later part of the range if keyboard-tracking is disabled.

See also minimumTime, maximumTime, setDateTimeRange(), QTime::isValid(), and 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

This virtual function is used by the date time edit whenever it needs to display dateTime.

If you reimplement this, you may also need to reimplement validate().

See also dateTimeFromText() and validate().

QTime QDateTimeEdit::time() const

Returns the time of the date time edit.

Note: Getter function for property time.

See also setTime().

[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).