Класс 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.

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

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

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

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

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

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

QDateTimeEdit::QDateTimeEdit(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(QDate date)

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

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

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

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

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

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

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

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

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

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

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

[virtual] QDateTimeEdit::~QDateTimeEdit()

Деструктор.

QCalendarWidget *QDateTimeEdit::calendarWidget() const

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

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

См. также 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).

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

Переопределяет: QAbstractSpinBox::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.

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

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

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

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

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(), и Отслеживание ввода с клавиатуры.

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(), и Отслеживание ввода с клавиатуры.

void QDateTimeEdit::setSelectedSection(QDateTimeEdit::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.

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

См. также 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).