Класс QBarCategoryAxis
Класс QBarCategoryAxis добавляет категории к осям диаграммы. Подробнее...
| Заголовок: | #include <QBarCategoryAxis> |
| Создаётся из: | BarCategoryAxis |
| Наследуется от: | QAbstractAxis |
Свойства
- categories : QStringList
- count : const int
- max : QString
- min : QString
Открытые функции
| QBarCategoryAxis(QObject *parent = nullptr) | |
| virtual | ~QBarCategoryAxis() |
| void | append(const QStringList &categories) |
| void | append(const QString &category) |
| QString | at(int index) const |
| QStringList | categories() |
| void | clear() |
| int | count() const |
| void | insert(int index, const QString &category) |
| QString | max() const |
| QString | min() const |
| void | remove(const QString &category) |
| void | replace(const QString &oldCategory, const QString &newCategory) |
| void | setCategories(const QStringList &categories) |
| void | setMax(const QString &max) |
| void | setMin(const QString &min) |
| void | setRange(const QString &minCategory, const QString &maxCategory) |
Реализованные открытые функции
| virtual QAbstractAxis::AxisType | type() const override |
Сигналы
| void | categoriesChanged() |
| void | countChanged() |
| void | maxChanged(const QString &max) |
| void | minChanged(const QString &min) |
| void | rangeChanged(const QString &min, const QString &max) |
Подробное описание
QBarCategoryAxis может быть настроен для отображения оси с метками, сетками и заливкой. Категории выводятся между метками. Также его можно использовать с линией серии, как показано в примере Линейный и столбиковый график.
Следующий код демонстрирует использование QBarCategoryAxis:
QChartView *chartView = new QChartView;
QBarSeries *series = new QBarSeries;
// ...
chartView->chart()->addSeries(series);
chartView->chart()->createDefaultAxes();
QBarCategoryAxis *axisX = new QBarCategoryAxis;
QStringList categories;
categories << "Jan" << "Feb" << "Mar" << "Apr" << "May" << "Jun";
axisX->append(categories);
axisX->setRange("Feb", "May");
chartView->chart()->setAxisX(axisX, series); Документация по свойствам
categories : QStringList
Это свойство содержит категории оси.
Функции доступа:
| QStringList | categories() |
| void | setCategories(const QStringList &categories) |
Сигнал уведомления:
| void | categoriesChanged() |
[read-only] count : const int
Это свойство содержит количество категорий оси.
Функции доступа:
| int | count() const |
Сигнал уведомления:
| void | countChanged() |
max : QString
Это свойство содержит максимальное значение на оси.
Функции доступа:
| QString | max() const |
| void | setMax(const QString &max) |
Сигнал уведомления:
| void | maxChanged(const QString &max) |
min : QString
Это свойство содержит минимальное значение на оси.
Функции доступа:
| QString | min() const |
| void | setMin(const QString &min) |
Сигнал уведомления:
| void | minChanged(const QString &min) |
Документация по функциям-членам
QBarCategoryAxis::QBarCategoryAxis(QObject *parent = nullptr)
Конструирует объект оси, который является дочерним элементом parent.
[signal] void QBarCategoryAxis::categoriesChanged()
Этот сигнал генерируется, когда категории оси изменяются.
Примечание: Сигнал уведомления для свойства categories.
[signal] void QBarCategoryAxis::countChanged()
Этот сигнал генерируется, когда количество категорий оси изменяется.
Примечание: Сигнал уведомления для свойства count.
[signal] void QBarCategoryAxis::maxChanged(const QString &max)
Этот сигнал генерируется, когда значение max оси изменяется.
Примечание: Сигнал уведомления для свойства max.
[signal] void QBarCategoryAxis::minChanged(const QString &min)
Этот сигнал генерируется, когда значение min оси изменяется.
Примечание: Сигнал уведомления для свойства min.
[signal] void QBarCategoryAxis::rangeChanged(const QString &min, const QString &max)
Этот сигнал испускается, когда значение min или max оси изменяется.
[virtual] QBarCategoryAxis::~QBarCategoryAxis()
Уничтожает объект оси.
void QBarCategoryAxis::append(const QStringList &categories)
Добавляет categories к оси. Максимальное значение на оси будет изменено для соответствия последней категории в categories. Если категории ранее не были определены, минимальное значение на оси также будет изменено для соответствия первой категории в categories.
Категория должна быть допустимым QString, и она не может быть дублирована. Дублированные категории не будут добавлены.
void QBarCategoryAxis::append(const QString &category)
Добавляет category к оси. Максимальное значение на оси будет изменено для соответствия последней category. Если категории ранее не были определены, минимальное значение на оси также будет изменено для соответствия category.
Категория должна быть допустимым QString, и она не может быть дублирована. Дублированные категории не будут добавлены.
QString QBarCategoryAxis::at(int index) const
Возвращает категорию по индексу index. Индекс должен быть корректным.
QStringList QBarCategoryAxis::categories()
Возвращает категории.
Примечание: Функция-геттер для свойства categories.
См. также setCategories().
[invokable] void QBarCategoryAxis::clear()
Удаляет все категории. Устанавливает максимальное и минимальное значения диапазона оси в QString::null.
Примечание: Эту функцию можно вызывать через механизм метаобъектов и из QML. См. Q_INVOKABLE.
int QBarCategoryAxis::count() const
Возвращает количество категорий.
Примечание: Функция-геттер для свойства count.
void QBarCategoryAxis::insert(int index, const QString &category)
Вставляет category на ось по индексу index. category должна быть допустимым QString, и она не может быть дублирована. Если category вставляется в начало или конец, минимальное и максимальное значения на оси обновляются соответственно.
QString QBarCategoryAxis::max() const
Возвращает максимальную категорию.
Примечание: Функция-геттер для свойства max.
См. также setMax().
QString QBarCategoryAxis::min() const
Возвращает минимальную категорию.
Примечание: Функция-геттер для свойства min.
См. также setMin().
void QBarCategoryAxis::remove(const QString &category)
Удаляет category с оси. Удаление категории, которая в настоящее время задаёт максимальное или минимальное значение на оси, повлияет на диапазон оси.
void QBarCategoryAxis::replace(const QString &oldCategory, const QString &newCategory)
Заменяет oldCategory на newCategory. Если oldCategory не существует на оси, ничего не делается. newCategory должна быть допустимым QString и не может быть дублирована. Если заменяется минимальная или максимальная категория, минимальное и максимальное значения на оси обновляются соответственно.
void QBarCategoryAxis::setCategories(const QStringList &categories)
Устанавливает categories и отбрасывает старые. Диапазон оси настраивается для соответствия первой и последней категории в categories.
Категория должна быть допустимым QString и не может быть дублирована.
Примечание: Функция-сеттер для свойства categories.
См. также categories().
void QBarCategoryAxis::setMax(const QString &max)
Устанавливает максимальную категорию на max.
Примечание: Функция-сеттер для свойства max.
См. также max().
void QBarCategoryAxis::setMin(const QString &min)
Устанавливает минимальную категорию на min.
Примечание: Функция-сеттер для свойства min.
См. также min().
void QBarCategoryAxis::setRange(const QString &minCategory, const QString &maxCategory)
Устанавливает диапазон оси от minCategory до maxCategory.
[override virtual] QAbstractAxis::AxisType QBarCategoryAxis::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/qbarcategoryaxis.html