QDateTimeEdit Class

成员函数文档

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

使用parent 创建一个空的日期时间编辑器。

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

使用parent 创建一个空的日期时间编辑器。其值设置为date 。

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

使用parent 创建一个空的日期时间编辑器。其值设置为time 。

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

使用parent 创建一个空的日期时间编辑器。其值设置为datetime 。

[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()。

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

每当日期发生变化时，都会触发此信号。新日期将通过date 传递进来。

另请参阅 Keyboard Tracking 。

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

每当日期或时间发生变化时，都会触发此信号。新的日期和时间将通过datetime 传递进来。

另请参阅 Keyboard Tracking 。

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

返回与给定的text 对应的适当日期时间。

每当“日期时间”编辑框需要将用户输入的文本解释为数值时，都会调用此虚拟函数。

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

[override virtual] bool QDateTimeEdit::event(QEvent *event)

重写了：QAbstractSpinBox::event(QEvent *event)。

[override virtual protected] void QDateTimeEdit::fixup(QString &input) const

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

[override virtual protected] void QDateTimeEdit::focusInEvent(QFocusEvent *event)

重写了：QAbstractSpinBox::focusInEvent(QFocusEvent *event)。

[override virtual protected] bool QDateTimeEdit::focusNextPrevChild(bool next)

重新实现了：QWidget::focusNextPrevChild （bool next）。

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

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

使用此 QDataTimeEdit 中的值初始化option 。当子类需要一个QStyleOptionSpinBox ，但又不希望自己填写所有信息时，此方法非常有用。

另请参阅 QStyleOption::initFrom()。

[override virtual protected] void QDateTimeEdit::keyPressEvent(QKeyEvent *event)

重写了：QAbstractSpinBox::keyPressEvent(QKeyEvent *event)。

[override virtual protected] void QDateTimeEdit::mousePressEvent(QMouseEvent *event)

重写了：QAbstractSpinBox::mousePressEvent(QMouseEvent *event)。

[override virtual protected] void QDateTimeEdit::paintEvent(QPaintEvent *event)

重写了：QAbstractSpinBox::paintEvent(QPaintEvent *event)。

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

返回位于index 的部分。

如果格式为“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);

相当于：

setMinimumDate(min);
setMaximumDate(max);

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

如果时间范围小于其末端所涵盖的时间间隔（例如，跨越月底的一周），则当键盘跟踪功能被禁用时，用户只能将日期编辑为该范围后半部分的日期。

另请参阅 minimumDate 、maximumDate 、setDateTimeRange()、QDate::isValid() 以及Keyboard Tracking 。

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

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

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

setDateTimeRange(min, max);

其作用类似于：

setMinimumDateTime(min);
setMaximumDateTime(max);

如果min 或max 中的任一值无效，则此函数不执行任何操作。如果max 小于min ，则min 也将被用作max 。

如果时间范围比其涵盖的结束时间更窄（例如，跨越月底的一周），则当键盘跟踪功能被禁用时，用户只能将日期和时间编辑为该范围后半部分的某个值。

另请参阅 minimumDateTime 、maximumDateTime 、setDateRange()、setTimeRange()、QDateTime::isValid() 以及Keyboard Tracking 。

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

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

另请参阅 currentSection()。

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

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

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

请注意，这些设置仅分别对minimumDate 和maximumDate 上的日期时间编辑框的值进行限制。当这些日期属性不一致时，在max 之后的时间在maximumDate 之前的日期中是允许的，而在min 之前的时间在minimumDate 之后的日期中也是允许的。

setTimeRange(min, max);

这相当于：

setMinimumTime(min);
setMaximumTime(max);

如果min 或max 中的任意一个无效，则该函数不执行任何操作。该函数保留minimumDate 和maximumDate 属性。如果这些属性一致，且max 小于min ，则将min 作为max 使用。

如果时间范围较窄，且该时间点处于某个时间区间的末端（例如从10点到1小时，再到同一小时的10分），则只有在禁用键盘跟踪功能时，用户才能将时间编辑为该范围后半部分中的某个时间点。

另请参阅 minimumTime 、maximumTime 、setDateTimeRange()、QTime::isValid() 以及Keyboard Tracking 。

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

重新实现了：QAbstractSpinBox::sizeHint() const。

[override virtual] void QDateTimeEdit::stepBy(int steps)

重新实现了：QAbstractSpinBox::stepBy （int steps）。

[override virtual protected] QAbstractSpinBox::StepEnabled QDateTimeEdit::stepEnabled() const

重新实现了：QAbstractSpinBox::stepEnabled() const。

[virtual protected] QString QDateTimeEdit::textFromDateTime(const QDateTime &dateTime) const

每当日期时间编辑控件需要显示dateTime 时，都会调用此虚拟函数。

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

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

QTime QDateTimeEdit::time() const

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

另请参阅 setTime()。

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

每当时间发生变化时，都会触发此信号。新时间将通过 `time` 传递进来。

另请参阅 Keyboard Tracking 。

[override virtual protected] QValidator::State QDateTimeEdit::validate(QString &text, int &pos) const

重写了：QAbstractSpinBox::validate(QString &input, int &pos) const。

[override virtual protected] void QDateTimeEdit::wheelEvent(QWheelEvent *event)

重写：QAbstractSpinBox::wheelEvent(QWheelEvent *event)。