Класс QValueAxis
Класс QValueAxis добавляет значения к осям графика. Подробнее...
| Заголовок: | #include <QValueAxis> |
| Создается из: | ValueAxis |
| Наследуется от: | QAbstractAxis |
| Наследуется в: |
Типы публичного интерфейса
| перечисление | TickType { TicksDynamic, TicksFixed } |
Свойства
|
|
Публичные функции
| QValueAxis(QObject *parent = nullptr) | |
| виртуальный | ~QValueAxis() |
| QString | labelFormat() const |
| qreal | max() const |
| qreal | min() const |
| int | minorTickCount() const |
| void | setLabelFormat(const QString &format) |
| void | setMax(qreal max) |
| void | setMin(qreal min) |
| void | setMinorTickCount(int count) |
| void | setRange(qreal min, qreal max) |
| void | setTickAnchor(qreal anchor) |
| void | setTickCount(int count) |
| void | setTickInterval(qreal insterval) |
| void | setTickType(QValueAxis::TickType type) |
| qreal | tickAnchor() const |
| int | tickCount() const |
| qreal | tickInterval() const |
| QValueAxis::TickType | tickType() const |
Переопределенные публичные функции
| виртуальный QAbstractAxis::AxisType | type() const override |
Открытые слоты
| void | applyNiceNumbers() |
Сигналы
| void | изменилсяФорматМетки(const QString &format) |
| void | maxИзменился(qreal max) |
| void | minИзменился(qreal min) |
| void | minorTickCountИзменился(int minorTickCount) |
| void | изменилсяДиапазон(qreal min, qreal max) |
| void | tickAnchorИзменился(qreal anchor) |
| void | tickCountИзменился(int tickCount) |
| void | tickIntervalИзменился(qreal interval) |
| void | tickTypeИзменился(QValueAxis::TickType type) |
Подробное описание
Ось значений может быть настроена для отображения линии оси с метками, сетками и заливкой. Значения на оси отображаются в позициях меток.
Следующий пример кода демонстрирует, как использовать класс QValueAxis:
QChartView *chartView = new QChartView;
QLineSeries *series = new QLineSeries;
// ...
chartView->chart()->addSeries(series);
QValueAxis *axisX = new QValueAxis;
axisX->setRange(10, 20.5);
axisX->setTickCount(10);
axisX->setLabelFormat("%.2f");
chartView->chart()->setAxisX(axisX, series); Документация по типам членов
перечисление QValueAxis::TickType
Это перечисление описывает, как метки и подписи размещаются на оси.
| Постоянная | Значение | Описание |
|---|---|---|
QValueAxis::TicksDynamic |
0 |
Метки размещаются в соответствии со значениями tickAnchor и tickInterval. |
QValueAxis::TicksFixed |
1 |
Метки размещаются равномерно по всему диапазону оси. Значение tickCount определяет количество меток. |
Документация свойств
labelFormat : QString
Это свойство содержит формат метки оси.
Строка формата поддерживает следующие спецификаторы преобразования, модификаторы длины и флаги, предоставленные printf(), в стандартной библиотеке C++: d, i, o, x, X, f, F, e, E, g, G, c.
Если QChart::localizeNumbers равно true, поддерживаемые спецификаторы ограничены: d, e, E, f, g, G и i. Также поддерживается только модификатор точности. Остальная часть форматирования берется из стандартной QLocale приложения.
Функции доступа:
| QString | labelFormat() const |
| void | setLabelFormat(const QString &format) |
Сигнал уведомления:
| void | labelFormatChanged(const QString &format) |
См. также QString::asprintf().
max : qreal
Это свойство содержит максимальное значение на оси.
При установке этого свойства минимальное значение корректируется при необходимости, чтобы обеспечить сохранение допустимого диапазона.
Функции доступа:
| qreal | max() const |
| void | setMax(qreal max) |
Сигнал уведомления:
| void | maxChanged(qreal max) |
min : qreal
Это свойство содержит минимальное значение на оси.
При установке этого свойства максимальное значение корректируется при необходимости, чтобы обеспечить сохранение допустимого диапазона.
Функции доступа:
| qreal | min() const |
| void | setMin(qreal min) |
Сигнал уведомления:
| void | minChanged(qreal min) |
minorTickCount : int
Это свойство содержит количество мелких отметки на оси. Это указывает, сколько линий сетки отображается между основными отметками на графике. Метки для мелких отметок не отображаются. Значение по умолчанию равно 0.
Функции доступа:
| int | minorTickCount() const |
| void | setMinorTickCount(int count) |
Сигнал уведомления:
| void | minorTickCountChanged(int minorTickCount) |
[since 5.12] tickAnchor : qreal
Это свойство содержит базовое значение, с которого начинаются динамически размещаемые отметки и метки.
Это свойство было добавлено в Qt 5.12.
Функции доступа:
| qreal | tickAnchor() const |
| void | setTickAnchor(qreal anchor) |
Сигнал уведомления:
| void | tickAnchorChanged(qreal anchor) |
tickCount : int
Это свойство содержит количество отметок на оси. Это указывает, сколько линий сетки отображается на графике. Значение по умолчанию равно 5, а количество не может быть меньше 2.
Функции доступа:
| int | tickCount() const |
| void | setTickCount(int count) |
Сигнал уведомления:
| void | tickCountChanged(int tickCount) |
[since 5.12] tickInterval : qreal
Это свойство содержит интервал между динамически размещаемыми отметками и метками.
Это свойство было добавлено в Qt 5.12.
Функции доступа:
| qreal | tickInterval() const |
| void | setTickInterval(qreal insterval) |
Сигнал уведомления:
| void | tickIntervalChanged(qreal interval) |
[since 5.12] tickType : TickType
Это свойство содержит метод позиционирования отметок и меток.
Это свойство было добавлено в Qt 5.12.
Функции доступа:
| QValueAxis::TickType | tickType() const |
| void | setTickType(QValueAxis::TickType type) |
Сигнал уведомления:
| void | tickTypeChanged(QValueAxis::TickType type) |
Документация функций-членов
QValueAxis::QValueAxis(QObject *parent = nullptr)
Создает объект оси, являющийся дочерним элементом parent.
[slot] void QValueAxis::applyNiceNumbers()
Изменяет текущий диапазон и количество отметок на оси, чтобы она выглядела "красиво". Алгоритм учитывает числа, которые могут быть выражены в форме 1*10^n, 2* 10^n или 5*10^n, как "красивые" числа. Эти числа используются для задания интервала между отметками.
См. также setRange() и setTickCount().
[signal] void QValueAxis::labelFormatChanged(const QString &format)
Этот сигнал генерируется при изменении формата меток оси.
Примечание: Сигнал уведомления для свойства labelFormat.
[signal] void QValueAxis::maxChanged(qreal max)
Этот сигнал генерируется при изменении максимального значения оси, указанного как max.
Примечание: Сигнал уведомления для свойства max.
[signal] void QValueAxis::minChanged(qreal min)
Этот сигнал генерируется при изменении минимального значения оси, указанного как min.
Примечание: Сигнал уведомления для свойства min.
[signal] void QValueAxis::minorTickCountChanged(int minorTickCount)
Этот сигнал генерируется при изменении количества мелких отметок на оси, указанного как minorTickCount.
Примечание: Сигнал уведомления для свойства minorTickCount.
[signal] void QValueAxis::rangeChanged(qreal min, qreal max)
Этот сигнал генерируется при изменении минимального или максимального значения оси, указанных как min и max.
[signal] void QValueAxis::tickCountChanged(int tickCount)
Этот сигнал генерируется при изменении количества отметок на оси, указанного как tickCount.
Примечание: Сигнал уведомления для свойства tickCount.
[virtual] QValueAxis::~QValueAxis()
Уничтожает объект.
void QValueAxis::setRange(qreal min, qreal max)
Устанавливает диапазон от min до max на оси. Если min больше, чем max, эта функция возвращается без каких-либо изменений.
[override virtual] QAbstractAxis::AxisType QValueAxis::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/qvalueaxis.html
