Класс 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 контролируется свойствами minimumDateTime, maximumDateTime и их соответствующими компонентами даты и времени. По умолчанию допустима любая дата-время с начала 100 года н. э. до конца 9999 года н. э.

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

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

Отслеживание ввода с клавиатуры

Когда отслеживание ввода с клавиатуры включено (по умолчанию), каждое нажатие клавиши при редактировании поля генерирует сигналы для изменения значения.

Когда допустимый диапазон ужесточён, меньше какого-то временного интервала, конец которого он захватывает, отслеживание ввода с клавиатуры предотвращает редактирование пользователем даты или времени для доступа к более поздней части интервала. Например, для диапазона с 29.04.2020 по 02.05.2020 и начальной датой 30.04.2020 пользователь не может изменить ни месяц (30 мая выходит за пределы диапазона), ни день (2 апреля выходит за пределы диапазона).

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

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

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

enum QDateTimeEdit::Sectionflags QDateTimeEdit::Sections

Тип Sections — это псевдоним для QFlags<Section>. Он хранит объединение значений Section через операцию OR.

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

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

Создаёт пустой редактор даты и времени с родительским элементом. Значение устанавливается в time.

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

Создаёт пустой редактор даты и времени с родительским элементом. Значение устанавливается в date.

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

Создаёт пустой редактор даты и времени с родительским элементом. Значение устанавливается в datetime.

QDateTimeEdit::QDateTimeEdit(QWidget *parent = nullptr)

Создаёт пустой редактор даты и времени с родительским элементом.

[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

Возвращает Section в index.

Если формат 'yyyy/MM/dd', 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)

Устанавливает диапазон допустимых дат для редактора даты и времени.

Эта функция-удобство устанавливает свойства minimumDate и maximumDate.

аналогично:

Если 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.

аналогично:

Если min или max недействительны, эта функция ничего не делает. Если max меньше min, min используется также как max.

Если диапазон уже, чем интервал времени, который он охватывает, например, неделя, которая охватывает конец месяца, пользователи могут редактировать дату и время только на более позднюю часть диапазона, если отслеживание клавиатуры отключено.

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

См. также minimumDateTime, maximumDateTime, setDateRange(), setTimeRange(), 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)

Устанавливает диапазон допустимых времен для редактирования даты и времени.

Эта вспомогательная функция устанавливает свойства minimumTime и maximumTime.

Обратите внимание, что эти свойства ограничивают значение редактирования даты и времени соответственно по minimumDate и maximumDate. Когда эти свойства дат не совпадают, времена после max разрешены в датах до maximumDate, а времена до min разрешены в датах после minimumDate.

setTimeRange(min, max);

аналогично:

setMinimumTime(min);
setMaximumTime(max);

Если min или max некорректно, эта функция ничего не делает. Эта функция сохраняет свойства minimumDate и maximumDate. Если эти свойства совпадают, а max меньше min, то min используется как max.

Если диапазон уже, чем интервал времени, который он охватывает, например, интервал от 10 до 11 часов, пользователи могут редактировать время только на более позднюю часть диапазона, если отслеживание клавиатуры отключено.

См. также minimumTime, maximumTime, setDateTimeRange(), 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).