Класс QCategoryAxis
Класс QCategoryAxis размещает именованные диапазоны на оси. Подробнее...
| Заголовок: | #include <QCategoryAxis> |
| Инициализируется из: | CategoryAxis |
| Наследуется от: | QValueAxis |
Типы
| Перечисление | AxisLabelsPosition { AxisLabelsPositionCenter, AxisLabelsPositionOnValue } |
Свойства
- categoriesLabels : const QStringList
- count : const int
- labelsPosition : AxisLabelsPosition
- startValue : qreal
Открытые функции
| QCategoryAxis(QObject *parent = nullptr) | |
| virtual | ~QCategoryAxis() |
| void | append(const QString &categoryLabel, qreal categoryEndValue) |
| QStringList | categoriesLabels() |
| int | count() const |
| qreal | endValue(const QString &categoryLabel) const |
| QCategoryAxis::AxisLabelsPosition | labelsPosition() const |
| void | remove(const QString &categoryLabel) |
| void | replaceLabel(const QString &oldLabel, const QString &newLabel) |
| void | setLabelsPosition(QCategoryAxis::AxisLabelsPosition position) |
| void | setStartValue(qreal min) |
| qreal | startValue(const QString &categoryLabel = QString()) const |
Переопределенные открытые функции
| virtual QAbstractAxis::AxisType | type() const override |
Сигналы
| void | categoriesChanged() |
| void | labelsPositionChanged(QCategoryAxis::AxisLabelsPosition position) |
Подробное описание
Этот класс можно использовать для объяснения исходных данных, добавив категорий с метками. В отличие от QBarCategoryAxis, QCategoryAxis позволяет свободно задавать ширину диапазонов категорий.
Пример кода, как использовать QCategoryAxis:
QChartView *chartView = new QChartView;
QLineSeries *series = new QLineSeries;
// ...
chartView->chart()->addSeries(series);
QCategoryAxis *axisY = new QCategoryAxis;
axisY->setMin(0);
axisY->setMax(52);
axisY->setStartValue(15);
axisY->append("First", 20);
axisY->append("Second", 37);
axisY->append("Third", 52);
chartView->chart()->setAxisY(axisY, series); Документация по типам членов
Перечисление QCategoryAxis::AxisLabelsPosition
Это перечисление описывает положение меток категорий.
| Постоянная | Значение | Описание |
|---|---|---|
QCategoryAxis::AxisLabelsPositionCenter |
0x0 |
Метки центрированы относительно категории. |
QCategoryAxis::AxisLabelsPositionOnValue |
0x1 |
Метки позиционированы на верхней границе категории. |
Документация по свойствам
[read-only] categoriesLabels : const QStringList
Это свойство хранит метки категорий в виде списка строк.
Функции доступа:
| QStringList | categoriesLabels() |
[read-only] count : const int
Это свойство хранит количество категорий.
Функции доступа:
| int | count() const |
labelsPosition : AxisLabelsPosition
Это свойство хранит положение меток категорий. Метки в начале и в конце осей могут перекрывать метки других осей, когда позиционированы на значение.
Функции доступа:
| QCategoryAxis::AxisLabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QCategoryAxis::AxisLabelsPosition position) |
Сигнал уведомления:
| void | labelsPositionChanged(QCategoryAxis::AxisLabelsPosition position) |
startValue : qreal
Это свойство хранит нижний предел первой категории на оси.
Функции доступа:
| qreal | startValue(const QString &categoryLabel = QString()) const |
| void | setStartValue(qreal min) |
Документация по функциям членов
QCategoryAxis::QCategoryAxis(QObject *parent = nullptr)
Создает объект оси, являющийся дочерним по отношению к parent.
[signal] void QCategoryAxis::categoriesChanged()
Этот сигнал генерируется при изменении категорий оси.
[virtual] QCategoryAxis::~QCategoryAxis()
Удаляет объект.
void QCategoryAxis::append(const QString &categoryLabel, qreal categoryEndValue)
Добавляет новую категорию к оси с меткой categoryLabel. Метка категории должна быть уникальной. categoryEndValue определяет верхнюю границу категории. Она должна быть больше, чем верхняя граница предыдущей категории. В противном случае метод завершается без добавления новой категории.
QStringList QCategoryAxis::categoriesLabels()
Возвращает список меток категорий.
Примечание: Функция-получатель для свойства categoriesLabels.
int QCategoryAxis::count() const
Возвращает количество категорий.
Примечание: Функция-получатель для свойства count.
qreal QCategoryAxis::endValue(const QString &categoryLabel) const
Возвращает верхнюю границу категории, указанной меткой categoryLabel.
void QCategoryAxis::remove(const QString &categoryLabel)
Удаляет категорию, указанную меткой categoryLabel, с оси.
void QCategoryAxis::replaceLabel(const QString &oldLabel, const QString &newLabel)
Заменяет существующую метку категории, указанную oldLabel, на newLabel. Если старой метки не существует, метод завершается без изменений.
void QCategoryAxis::setStartValue(qreal min)
Устанавливает min как нижнюю границу первой категории на оси. Если категории уже добавлены на ось, переданное значение должно быть меньше верхней границы уже определенного диапазона первой категории. В противном случае ничего не выполняется.
Примечание: Метод-сеттер для свойства startValue.
См. также startValue().
qreal QCategoryAxis::startValue(const QString &categoryLabel = QString()) const
Возвращает нижнюю границу категории, указанной categoryLabel.
Примечание: Метод-геттер для свойства startValue.
См. также setStartValue().
[override virtual] QAbstractAxis::AxisType QCategoryAxis::type() const
Переопределяет: QValueAxis::type() const.
Возвращает тип оси.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qcategoryaxis.html