Класс QDateTimeEdit

Класс QDateTimeEdit предоставляет виджет для редактирования дат и времени. Подробнее...

• Список всех членов, включая унаследованные

Открытые типы

Свойства

Открытые функции

Реализованные публичные функции

Публичные слоты

Сигналы

Защищенные функции

Переопределённые защищённые функции

Подробное описание

QDateTimeEdit позволяет пользователю редактировать даты с помощью клавиатуры или клавиш со стрелками для увеличения и уменьшения значений даты и времени. Клавиши со стрелками могут использоваться для перехода от раздела к разделу в поле QDateTimeEdit. Даты и время отображаются в соответствии с заданным форматом; см. setDisplayFormat().

QDateTimeEdit *dateEdit = new QDateTimeEdit(QDate::currentDate());
dateEdit->setMinimumDate(QDate::currentDate().addDays(-365));
dateEdit->setMaximumDate(QDate::currentDate().addDays(365));
dateEdit->setDisplayFormat("yyyy.MM.dd");

Здесь мы создали новый объект QDateTimeEdit, инициализированный сегодняшней датой, и ограничили допустимый диапазон дат сегодняшней датой плюс-минус 365 дней. Мы установили порядок: месяц, день, год.

Минимальное значение для QDateTimeEdit — 14 сентября 1752 года. Вы можете изменить это, вызвав setMinimumDate(), учитывая, что минимальное значение для QDate — 2 января 4713 г. до н. э.

Другие полезные функции: setMaximumDate(), setMinimumTime() и setMaximumTime().

Использование всплывающего календарного виджета

QDateTimeEdit может быть сконфигурирован для использования QCalendarWidget для выбора дат. Это включается путем установки свойства calendarPopup. Кроме того, вы можете предоставить пользовательский виджет календаря для использования в качестве всплывающего календаря, вызвав функцию setCalendarWidget(). Существующий виджет календаря может быть получен с помощью calendarWidget().

См. также QDateEdit, QTimeEdit, QDate и QTime.

Документация по типам членов

перечисление QDateTimeEdit::Sectionфлаги QDateTimeEdit::Sections

Тип Sections — это псевдоним для QFlags<Section>. Он хранит логическое ИЛИ сочетание значений Section.

Документация по членам-функциям

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

Конструирует пустой редактор даты и времени с заданным parent. Значение устанавливается в time.

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

Конструирует пустой редактор даты и времени с заданным parent. Значение устанавливается в date.

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

Конструирует пустой редактор даты и времени с заданным parent. Значение устанавливается в datetime.

QDateTimeEdit::QDateTimeEdit(QWidget *parent = nullptr)

Конструирует пустой редактор даты и времени с заданным parent.

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

Этот сигнал испускается при изменении даты. Новая дата передаётся в date.

Примечание: Сигнал уведомления для свойства date.

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

Этот сигнал испускается при изменении даты или времени. Новая дата и время передаются в datetime.

Примечание: Сигнал уведомления для свойства dateTime.

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

Этот сигнал испускается при изменении времени. Новое время передаётся в time.

Примечание: Сигнал уведомления для свойства time.

[virtual] QDateTimeEdit::~QDateTimeEdit()

Деструктор.

QCalendarWidget *QDateTimeEdit::calendarWidget() const

Возвращает виджет календаря для редактора, если calendarPopup установлен в true и (sections() & DateSections_Mask) != 0.

Эта функция создаёт и возвращает виджет календаря, если он не был задан.

Эта функция была добавлена в Qt 4.4.

См. также setCalendarWidget().

[override virtual] void QDateTimeEdit::clear()

Переопределяет: QAbstractSpinBox::clear().

QDate QDateTimeEdit::date() const

Возвращает дату из виджета редактирования даты и времени.

Примечание: Функция-геттер для свойства date.

См. также setDate().

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

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

Инициализирует option значениями из этого QDataTimeEdit. Этот метод полезен для подклассов, когда им нужен 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.

Если формат — 'гггг/мм/дд', sectionAt(0) возвращает YearSection, sectionAt(1) возвращает MonthSection, а sectionAt(2) возвращает YearSection.

Эта функция была добавлена в Qt 4.3.

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

Возвращает текст из заданного раздела section.

См. также currentSection().

void QDateTimeEdit::setCalendarWidget(QCalendarWidget *calendarWidget)

Устанавливает указанный calendarWidget как виджет, используемый для всплывающего календаря. Редактор не принимает на себя автоматическое управление виджетом календаря.

Примечание: calendarPopup должен быть установлен в значение true перед установкой виджета календаря.

Эта функция была добавлена в Qt 4.4.

См. также calendarWidget() и calendarPopup.

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

Удобная функция для установки минимальной и максимальной даты одним вызовом.

setDateRange(min, max);

аналогично:

setMinimumDate(min);
setMaximumDate(max);

Если min или max некорректны, эта функция ничего не делает.

См. также setMinimumDate(), maximumDate(), setMaximumDate(), clearMinimumDate(), setMinimumTime(), maximumTime(), setMaximumTime(), clearMinimumTime() и QDate::isValid().

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

Функция-удобство для установки минимального и максимального времени и даты одним вызовом.

setDateTimeRange(min, max);

аналогична:

setMinimumDateTime(min);
setMaximumDateTime(max);

Если min или max некорректны, эта функция ничего не делает.

Эта функция была добавлена в Qt 4.4.

См. также setMinimumDate(), maximumDate(), setMaximumDate(), clearMinimumDate(), setMinimumTime(), maximumTime(), setMaximumTime(), clearMinimumTime() и QDateTime::isValid().

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

Выбирает section. Если section не существует в текущих отображаемых разделах, эта функция ничего не делает. Если section — NoSection, эта функция сбросит выделение всего текста в редакторе. В противном случае, функция переместит курсор и текущий раздел в выбранный раздел.

Эта функция была добавлена в Qt 4.2.

См. также currentSection().

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

Функция-удобство для установки минимального и максимального времени одним вызовом.

setTimeRange(min, max);

аналогична:

setMinimumTime(min);
setMaximumTime(max);

Если min или max некорректны, эта функция ничего не делает.

См. также setMinimumDate(), maximumDate(), setMaximumDate(), clearMinimumDate(), setMinimumTime(), maximumTime(), setMaximumTime(), clearMinimumTime() и QTime::isValid().

[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

Возвращает время элемента редактирования даты и времени.

Примечание: Функция-геттер для свойства time.

См. также setTime().

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