Класс QDateTimeEdit

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

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

Открытые типы

Свойства

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

Открытые функции

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

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

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

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

Сигналы

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

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

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

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

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

• 1 общедоступная переменная, унаследованная от QObject
• 5 статические общедоступные члены, унаследованные от QWidget
• 10 статических общедоступных членов, унаследованных от QObject
• 1 защищённый слот, унаследованный от QWidget
• 2 защищённые переменные, унаследованные от QObject
• 1 защищённый тип, унаследованный от QPaintDevice

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

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