QDateTimeEdit 类

成员函数文档

[explicit] QDateTimeEdit::QDateTimeEdit(QWidget *parent = nullptr)

使用父对象构造一个空的日期时间编辑器。

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

使用父对象构造一个空的日期时间编辑器，并将值设置为 datetime。

[explicit] QDateTimeEdit::QDateTimeEdit(QDate date, QWidget *parent = nullptr)

使用父对象构造一个空的日期时间编辑器，并将值设置为 date。

[explicit] QDateTimeEdit::QDateTimeEdit(QTime time, QWidget *parent = nullptr)

使用父对象构造一个空的日期时间编辑器，并将值设置为 time。

[virtual noexcept] QDateTimeEdit::~QDateTimeEdit()

析构函数。

QCalendar QDateTimeEdit::calendar() const

报告此小部件使用的日历系统。

另见 setCalendar().

QCalendarWidget *QDateTimeEdit::calendarWidget() const

如果 calendarPopup 设置为 true 并且 (sections() & DateSections_Mask) != 0，则返回编辑器的日历小部件。

此函数创建并返回一个日历小部件（如果尚未设置）。

另见 setCalendarWidget().

[override virtual] void QDateTimeEdit::clear()

重新实现: QAbstractSpinBox::clear().

QDate QDateTimeEdit::date() const

返回日期时间编辑的日期。

另见 setDate().

[信号] void QDateTimeEdit::dateChanged(QDate date)

每当日期改变时，都会发出这个信号。新日期通过 date 参数传入。

另请参阅：键盘跟踪。

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

每当日期或时间改变时，都会发出这个信号。新日期和时间通过 datetime 参数传入。

另请参阅：键盘跟踪。

[虚保护] QDateTime QDateTimeEdit::dateTimeFromText(const QString &text) const

根据给定的 text 返回适当的日期时间。

这个虚函数被日期编辑控件用于将其用户输入的文本书面值解释为值。

另请参阅：textFromDateTime() 和 validate()。

[重载虚函数] bool QDateTimeEdit::event(QEvent *event)

重实现：QAbstractSpinBox::event(QEvent *event)。

[重载虚保护] void QDateTimeEdit::fixup(QString &input) const

重实现：QAbstractSpinBox::fixup(QString &input) const。

[重载虚保护] void QDateTimeEdit::focusInEvent(QFocusEvent *event)

重实现：QAbstractSpinBox::focusInEvent(QFocusEvent *event)。

[重载虚保护] bool QDateTimeEdit::focusNextPrevChild(bool next)

重实现：QWidget::focusNextPrevChild(bool next)。

[重载虚保护] void QDateTimeEdit::initStyleOption(QStyleOptionSpinBox *option) const

重实现：QAbstractSpinBox::initStyleOption(QStyleOptionSpinBox *option) const。

使用此 QDataTimeEdit 的值初始化 option。当子类需要 QStyleOptionSpinBox，但不希望自填所有信息时，此方法很有用。

另请参阅：QStyleOption::initFrom。

[重载虚保护] void QDateTimeEdit::keyPressEvent(QKeyEvent *event)

重实现：QAbstractSpinBox::keyPressEvent(QKeyEvent *event)。

[重载虚保护] void QDateTimeEdit::mousePressEvent(QMouseEvent *event)

重新实现: QAbstractSpinBox::mousePressEvent(QMouseEvent *event).

[覆盖虚保护] void QDateTimeEdit::paintEvent(QPaintEvent *event)

重新实现: QAbstractSpinBox::paintEvent(QPaintEvent *event).

QDateTimeEdit::Section QDateTimeEdit::sectionAt(int index) const

返回索引位置的项。

如果格式是 'yyyy/MM/dd'，则 sectionAt(0) 返回 YearSection，sectionAt(1) 返回 MonthSection，sectionAt(2) 返回 YearSection，

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

返回给定 section 中的文本。

另请参阅currentSection。

void QDateTimeEdit::setCalendar(QCalendar calendar)

将 calendar 设置为该小部件要使用的日历系统。

小部件可以使用任何受支持的日历系统。默认情况下，它使用公历。

另请参阅calendar。

void QDateTimeEdit::setCalendarWidget(QCalendarWidget *calendarWidget)

将给定的 calendarWidget 设置为用于日历弹出窗口的小部件。编辑器不会自动获取日历小部件的所有权。

另请参阅calendarWidget() 和 calendarPopup。

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

设置日期时间编辑器允许的日期范围。

此便捷函数设置 minimumDate 和 maximumDate 属性。

setDateRange(min, max);

is analogous to

setMinimumDate(min);
setMaximumDate(max);

如果 min 或 max 无效，则此函数不执行任何操作。此函数保存 minimumTime 属性。如果 max 小于 min，则新的 maximumDateTime 属性应该是新的 minimumDateTime 属性。如果 max 等于 min 且 maximumTime 属性小于 minimumTime 属性，则将 maximumTime 属性设置为 minimumTime 属性。否则，它将保存 maximumTime 属性。

如果范围小于它所跨越的时间间隔，例如跨越月底的一周，如果禁用了键盘跟踪，则用户只能编辑日期到范围后面的日期。

另请参阅 minimumDate、maximumDate、setDateTimeRange()、QDate::isValid()，以及键盘跟踪。

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

设置日期时间编辑器允许的日期时间范围。

此便捷函数设置minimumDateTime和maximumDateTime属性。

setDateTimeRange(min, max);

is analogous to

setMinimumDateTime(min);
setMaximumDateTime(max);

如果min或max无效，此函数不执行任何操作。如果max小于min，则使用min作为max。

如果范围比跨其终点的时距更窄，例如跨越月底的一周，用户只能在禁用键盘跟踪的情况下将日期时间编辑到范围的后半部分。

另请参阅 minimumDateTime、maximumDateTime、setDateRange、setTimeRange、QDateTime::isValid，以及键盘跟踪。

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

选择section。如果当前显示的段落中不存在section，则此函数不执行任何操作。如果section为NoSection，则此函数将取消选择编辑器中的所有文本。否则，此函数将移动光标和当前段落到选择的段落。

另请参阅currentSection。

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

设置日期时间编辑器允许的时间范围。

此便捷函数设置minimumTime和maximumTime属性。

请注意，这些仅约束日期时间编辑器的值在分别的minimumDate和maximumDate上。当这些日期属性不一致时，在maximumDate之前的日期允许在max之后的时刻，在minimumDate之后的日期允许在min之前的时刻。

setTimeRange(min, max);

is analogous to

setMinimumTime(min);
setMaximumTime(max);

如果min或max无效，此函数不执行任何操作。此函数保留minimumDate和maximumDate属性。如果这些属性相同且max小于min，则使用min作为max。

如果范围比跨其终点的时距更窄，例如从十点到一个小时到十点后，如果禁用键盘跟踪，用户只能在范围的后半部分编辑时间。

另请参阅 minimumTime、maximumTime、setDateTimeRange、QTime::isValid，以及键盘跟踪。

[override virtual] QSize QDateTimeEdit::sizeHint() const

重新实现：未翻译
QAbstractSpinBox::sizeHint() const。

[重载虚函数] void QDateTimeEdit::stepBy(int steps)

重新实现：未翻译
QAbstractSpinBox::stepBy(int steps)。

[重载虚保护] QAbstractSpinBox::StepEnabled QDateTimeEdit::stepEnabled() const

重新实现：未翻译
QAbstractSpinBox::stepEnabled () const。

[虚保护] QString QDateTimeEdit::textFromDateTime(const QDateTime &dateTime) const

这个虚函数在日期时间编辑器需要显示 dateTime 时使用。

如果你重载了此函数，可能还需要重载 validate ()。

另请参阅dateTimeFromText () 和 validate ()。

QTime QDateTimeEdit::time() const

返回日期时间编辑的时间。

另请参阅setTime ()。

[信号] void QDateTimeEdit::timeChanged(QTime time)

当时间改变时，此信号会被发出。新时间通过 time 传递。

另请参阅：键盘跟踪。

[重载虚保护] QValidator::State QDateTimeEdit::validate(QString &text, int &pos) const

重新实现：未翻译
QAbstractSpinBox::validate(QString &input, int &pos) const。

[重载虚保护] void QDateTimeEdit::wheelEvent(QWheelEvent *event)

重新实现：未翻译
QAbstractSpinBox::wheelEvent(QWheelEvent *event)。