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

报告此 widget 使用的日历系统。

另请参见 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 设置为该 widget 使用的日历系统。

该 widget 可以使用任何支持的日历系统。默认情况下，它使用公历。

另请参阅 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 上的日期时间编辑值。当这些日期属性不一致时，在maximumDate 之前的日期允许使用max 之后的时间，在minimumDate 之后的日期允许使用min 之前的时间。

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