Spec-Zone.ru › Qt

Класс 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API