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

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

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

enum QDateTimeEdit::Sectionflags 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

Возвращает подходящее значение datetime для заданного 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.

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

Функция была добавлена в 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)

Выбирает раздел. Если раздел не существует в текущих отображаемых разделах, функция ничего не делает. Если раздел равен 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.

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