Класс QCategoryAxis

Класс QCategoryAxis размещает именованные диапазоны на оси. Подробнее...

• Список всех членов, включая наследуемые

Открытые типы

Свойства

• categoriesLabels : const QStringList
• count : const int
• labelsPosition : AxisLabelsPosition
• startValue : qreal

Открытые функции

Переопределённые открытые функции

Сигналы

Подробное описание

Этот класс может быть использован для объяснения базовых данных, добавив помеченные категории. В отличие от 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::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.

Возвращает тип оси.