Класс QDateTimeEdit

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

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

Общедоступные типы

Свойства

• 12 свойств унаследовано от QAbstractSpinBox
• 59 свойств унаследовано от QWidget
• 1 свойство унаследовано от QObject

Общедоступные функции

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

• 30 публичных функций, унаследованных от QAbstractSpinBox
• 214 публичных функций, унаследованных от QWidget
• 31 публичной функции, унаследованной от QObject
• 14 публичных функций, унаследованных от QPaintDevice

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

• 4 публичных слота, унаследованных от QAbstractSpinBox
• 19 публичных слотов, унаследованных от QWidget
• 1 публичный слот, унаследованный от QObject

Сигналы

• 1 сигнал, унаследованный от QAbstractSpinBox
• 3 сигнала, унаследованные от QWidget
• 2 сигнала, унаследованные от QObject

Статические публичные члены

• 5 статических публичных членов, унаследованных от QWidget
• 9 статических публичных членов, унаследованных от QObject

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

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

• 20 защищенных функций, унаследованных от QAbstractSpinBox
• 35 защищенных функций, унаследованных от QWidget
• 9 защищенных функций, унаследованных от QObject
• 1 защищенная функция, унаследованная от QPaintDevice

Дополнительные унаследованные члены

• 1 защищенный слот, унаследованный от QWidget

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

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

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

enum QDateTimeEdit::Sectionflags QDateTimeEdit::Sections

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

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

QDateTimeEdit::QDateTimeEdit(QWidget *parent = nullptr)

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

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

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

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

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

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

Создаёт пустой редактор даты и времени с parent. Значение устанавливается в 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().

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

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

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

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

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

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

[virtual protected] QDateTime QDateTimeEdit::dateTimeFromText(const QString &text) const

Возвращает подходящую дату и время для заданного значения text.

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

См. также textFromDateTime() и validate().

[override virtual] bool QDateTimeEdit::event(QEvent *event)

Переопределено из QAbstractSpinBox::event().

[override virtual protected] void QDateTimeEdit::fixup(QString &input) const

Переопределено из QAbstractSpinBox::fixup().

[override virtual protected] void QDateTimeEdit::focusInEvent(QFocusEvent *event)

Переопределено из QAbstractSpinBox::focusInEvent().

[override virtual protected] bool QDateTimeEdit::focusNextPrevChild(bool next)

Переопределено из QWidget::focusNextPrevChild().

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

Инициализирует option значениями из этого QDataTimeEdit. Этот метод полезен для подклассов, когда им требуется QStyleOptionSpinBox, но они не хотят заполнять всю информацию самостоятельно.

См. также QStyleOption::initFrom().

[override virtual protected] void QDateTimeEdit::keyPressEvent(QKeyEvent *event)

Переопределено из QAbstractSpinBox::keyPressEvent().

[override virtual protected] void QDateTimeEdit::mousePressEvent(QMouseEvent *event)

Переопределено из QAbstractSpinBox::mousePressEvent().

[override virtual protected] void QDateTimeEdit::paintEvent(QPaintEvent *event)

Переопределено из QAbstractSpinBox::paintEvent().

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

[override virtual] void QDateTimeEdit::stepBy(int steps)

Переопределено из QAbstractSpinBox::stepBy().

[override virtual protected] QAbstractSpinBox::StepEnabled QDateTimeEdit::stepEnabled() const

Переопределено из QAbstractSpinBox::stepEnabled().

[virtual protected] QString QDateTimeEdit::textFromDateTime(const QDateTime &dateTime) const

Эта виртуальная функция используется редактором даты и времени всякий раз, когда ему нужно отобразить dateTime.

Если вы переопределите эту функцию, вам, возможно, также потребуется переопределить validate().

См. также dateTimeFromText() и validate().

QTime QDateTimeEdit::time() const

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

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

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

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

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

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

[override virtual protected] QValidator::State QDateTimeEdit::validate(QString &text, int &pos) const

Переопределено из QAbstractSpinBox::validate().

[override virtual protected] void QDateTimeEdit::wheelEvent(QWheelEvent *event)

Переопределено из QAbstractSpinBox::wheelEvent().