Класс QDateTimeEdit

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

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

Типы

Свойства

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

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

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

• 30 общедоступных функций, унаследованных от QAbstractSpinBox
• 214 общедоступных функций, унаследованных от QWidget
• 32 общедоступных функций, унаследованных от 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().

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

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

class QDateTimeEdit::Section-перечисление

Тип Sections является typedef для 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().

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

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

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

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

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

Переопределено из QWidget::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)

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

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

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

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

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

Section QDateTimeEdit::sectionAt(int index) const

Возвращает Section по index.

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

Эта функция была добавлена в 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().

[override virtual] QSize QDateTimeEdit::sizeHint() const

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

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

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

[override 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.

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

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

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

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