Класс QDateTimeAxis
Класс QDateTimeAxis добавляет даты и время к оси диаграммы. Подробнее...
| Заголовок: | #include <QDateTimeAxis> |
| Инициализируется: | DateTimeAxis |
| Наследуется от: | QAbstractAxis |
Свойства
Открытые функции
| QDateTimeAxis(QObject *parent = nullptr) | |
| virtual | ~QDateTimeAxis() |
| QString | format() const |
| QDateTime | max() const |
| QDateTime | min() const |
| void | setFormat(QString format) |
| void | setMax(QDateTime max) |
| void | setMin(QDateTime min) |
| void | setRange(QDateTime min, QDateTime max) |
| void | setTickCount(int count) |
| int | tickCount() const |
Переопределенные открытые функции
| virtual QAbstractAxis::AxisType | type() const override |
Сигналы
| void | formatChanged(QString format) |
| void | maxChanged(QDateTime max) |
| void | minChanged(QDateTime min) |
| void | rangeChanged(QDateTime min, QDateTime max) |
| void | tickCountChanged(int tickCount) |
Подробное описание
QDateTimeAxis можно настроить для отображения оси с отметками, сеткой и заливкой. Метки можно настроить, установив соответствующий формат даты и времени. QDateTimeAxis корректно работает с датами с 4714 г. до н. э. по 287396 г. н. э. Другие ограничения, связанные с QDateTime, см. в документации QDateTime.
Примечание: QDateTimeAxis отключен на платформах, где qreal определен как float.
QDateTimeAxis можно использовать с любым QXYSeries. Для добавления точки данных в серию используется QDateTime::toMSecsSinceEpoch():
QLineSeries *series = new QLineSeries; QDateTime xValue; xValue.setDate(QDate(2012, 1 , 18)); xValue.setTime(QTime(9, 34)); qreal yValue = 12; series->append(xValue.toMSecsSinceEpoch(), yValue); xValue.setDate(QDate(2013, 5 , 11)); xValue.setTime(QTime(11, 14)); qreal yValue = 22; series->append(xValue.toMSecsSinceEpoch(), yValue);
Следующий фрагмент кода демонстрирует добавление серии в диаграмму и настройку QDateTimeAxis:
QChartView *chartView = new QChartView;
chartView->chart()->addSeries(series);
// ...
QDateTimeAxis *axisX = new QDateTimeAxis;
axisX->setFormat("dd-MM-yyyy h:mm");
chartView->chart()->setAxisX(axisX, series); Документация по свойствам
format : QString
Это свойство содержит строку формата, используемую при создании метки оси из объекта QDateTime.
См. документацию QDateTime для получения информации о том, как должна быть определена строка.
Функции доступа:
| QString | format() const |
| void | setFormat(QString format) |
Сигнал уведомления:
| void | formatChanged(QString format) |
См. также QChart::locale.
max : QDateTime
Это свойство содержит максимальное значение на оси.
При установке этого свойства минимальное значение корректируется при необходимости, чтобы диапазон оставался допустимым.
Функции доступа:
| QDateTime | max() const |
| void | setMax(QDateTime max) |
Сигнал уведомления:
| void | maxChanged(QDateTime max) |
min : QDateTime
Это свойство содержит минимальное значение на оси.
При установке этого свойства максимальное значение корректируется при необходимости, чтобы диапазон оставался допустимым.
Функции доступа:
| QDateTime | min() const |
| void | setMin(QDateTime min) |
Сигнал уведомления:
| void | minChanged(QDateTime min) |
tickCount : int
Это свойство содержит количество делений на оси.
Функции доступа:
| int | tickCount() const |
| void | setTickCount(int count) |
Сигнал уведомления:
| void | tickCountChanged(int tickCount) |
Документация по функциям-членам
QDateTimeAxis::QDateTimeAxis(QObject *parent = nullptr)
Конструирует объект оси, являющийся дочерним элементом parent.
[signal] void QDateTimeAxis::formatChanged(QString format)
Этот сигнал излучается при изменении формата format оси.
Примечание: Сигнал уведомления для свойства format.
[signal] void QDateTimeAxis::maxChanged(QDateTime max)
Этот сигнал излучается при изменении максимального значения оси, заданного max.
Примечание: Сигнал уведомления для свойства max.
[signal] void QDateTimeAxis::minChanged(QDateTime min)
Этот сигнал излучается при изменении минимального значения оси, заданного min.
Примечание: Сигнал уведомления для свойства min.
[signal] void QDateTimeAxis::rangeChanged(QDateTime min, QDateTime max)
Этот сигнал излучается при изменении минимального или максимального значения оси, заданных min и max.
[signal] void QDateTimeAxis::tickCountChanged(int tickCount)
Этот сигнал излучается при изменении количества делений на оси, заданном tickCount.
Примечание: Сигнал Notifier для свойства tickCount.
[virtual] QDateTimeAxis::~QDateTimeAxis()
Удаляет объект.
void QDateTimeAxis::setRange(QDateTime min, QDateTime max)
Устанавливает диапазон оси от min до max. Если min больше, чем max, функция возвращается без внесения изменений.
void QDateTimeAxis::setTickCount(int count)
Устанавливает количество отметки на оси в count.
Примечание: Функция-сеттер для свойства tickCount.
См. также tickCount().
int QDateTimeAxis::tickCount() const
Возвращает количество отметки на оси.
Примечание: Функция-геттер для свойства tickCount.
См. также setTickCount().
[override virtual] QAbstractAxis::AxisType QDateTimeAxis::type() const
Переопределяет: QAbstractAxis::type() const.
Возвращает тип оси.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qdatetimeaxis.html