Класс QDateTimeEdit

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

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

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

Свойства

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

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

Реализованные общедоступные функции

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

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

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

Сигналы

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

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

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

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

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

• 5 статических публичных членов унаследованных от QWidget
• 11 статических публичных членов унаследованных от QObject
• 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().

	Виджет редактирования даты и времени, отображаемый в стиле виджета Windows Vista.
	Виджет редактирования даты и времени, отображаемый в стиле виджета Macintosh.
	Виджет редактирования даты и времени, отображаемый в стиле виджета Fusion.

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

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

enum QDateTimeEdit::Sectionflags QDateTimeEdit::Sections

Тип Sections является псевдонимом для QFlags<Section>. Он хранит комбинацию значений Section, объединённых оператором OR.

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

QDateTimeEdit::QDateTimeEdit(QWidget *parent = Q_NULLPTR)

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

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

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

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

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

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

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

QDateTimeEdit::~QDateTimeEdit()

Деструктор.

QCalendarWidget *QDateTimeEdit::calendarWidget() const

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

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

Эта функция была введена в Qt 4.4.

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

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

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

Переопределяет метод QObject::event().

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

Переопределяет метод QAbstractSpinBox::fixup().

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

Переопределяет метод QWidget::focusInEvent().

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

Переопределяет метод QWidget::focusNextPrevChild().

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

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

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

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

Переопределяет метод QWidget::keyPressEvent().

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

Переопределяет метод QWidget::mousePressEvent().

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

Переопределяет метод QWidget::paintEvent().

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

[virtual] QSize QDateTimeEdit::sizeHint() const

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

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

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

[virtual protected] 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.

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

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

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

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