Класс QValueAxis
Класс QValueAxis добавляет значения на оси диаграммы. Подробнее...
| Заголовок: | #include <QValueAxis> |
| Инициализируется из: | ValueAxis |
| Наследует: | QAbstractAxis |
| Наследуется в: |
Типы
| перечисление | TickType { TicksDynamic, TicksFixed } |
Свойства
|
|
Публичные функции
| QValueAxis(QObject *parent = nullptr) | |
| virtual | ~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 |
Переопределённые публичные функции
| virtual QAbstractAxis::AxisType | type() const override |
Открытые слоты
| void | applyNiceNumbers() |
Сигналы
| void | изменилсяФорматМетки(const QString &format) |
| void | максимумИзменился(qreal max) |
| void | минимумИзменился(qreal min) |
| void | изменилосьКол-воМеньшихДелений(int minorTickCount) |
| void | изменилсяДиапазон(qreal min, qreal max) |
| void | изменилсяЯкорДеления(qreal anchor) |
| void | изменилосьКол-воДелений(int tickCount) |
| void | изменилсяИнтервалДелений(qreal interval) |
| void | изменилсяТипДелений(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.2/qvalueaxis.html
