Класс 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) возвращает DaySection,

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

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

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

void QDateTimeEdit::setCalendarWidget(QCalendarWidget *calendarWidget)

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

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

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

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

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

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

аналогично:

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.

аналогично:

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