Back to Qt.io
Contact Us Blog Download Qt

QBarCategoryAxis Class

QBarCategoryAxis 类为图表的坐标轴添加类别。更多

Header: #include <QBarCategoryAxis>
In QML: BarCategoryAxis
Inherits: QAbstractAxis

属性

公共函数

QBarCategoryAxis(QObject *parent = nullptr)
virtual ~QBarCategoryAxis()
void append(const QString &category)
void append(const QStringList &categories)
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 可以设置为显示带有刻度线、网格线和阴影的轴线。在刻度线之间绘制类别。它也可与线性系列一起使用，如带 Widgets 图库的图表所示。

以下代码说明了如何使用 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)

成员函数 文档

[explicit] QBarCategoryAxis::QBarCategoryAxis(QObject *parent = nullptr)

构造一个轴对象，它是parent 的子对象。

[virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()

销毁轴对象。

void QBarCategoryAxis::append(const QString &category)

将category 添加到坐标轴。坐标轴上的最大值将更改为与最后的category 匹配。如果之前未定义任何类别，轴上的最小值也将改为与category 匹配。

类别必须是有效的QString ，并且不能重复。重复的类别将不会被添加。

void QBarCategoryAxis::append(const QStringList &categories)

将categories 添加到坐标轴。轴上的最大值将改为与categories 中的最后一个类别相匹配。如果之前没有定义类别，轴上的最小值也将改为与categories 中的第一个类别相匹配。

类别必须是有效的QString ，且不能重复。重复的类别将不会被添加。

QString QBarCategoryAxis::at(int index) const

返回index 中的类别。索引必须有效。

QStringList QBarCategoryAxis::categories()

返回类别。

注： 属性类别的获取函数。

另请参阅 setCategories()。

[signal] void QBarCategoryAxis::categoriesChanged()

当轴的类别发生变化时会发出该信号。

注： 属性categories 的通知信号。

[invokable] void QBarCategoryAxis::clear()

删除所有类别。将坐标轴范围的最大值和最小值设置为 QString::null。

注： 可通过元对象系统和 QML 调用此函数。请参见Q_INVOKABLE 。

int QBarCategoryAxis::count() const

返回类别数。

注： 属性计数的获取函数。

[signal] void QBarCategoryAxis::countChanged()

当轴的类别数发生变化时会发出该信号。

注： 属性count 的通知信号。

void QBarCategoryAxis::insert(int index, const QString &category)

将category 插入index 处的坐标轴。category 必须是有效的QString ，且不能重复。如果category 被预置或附加到其他类别，轴上的最小值和最大值也会相应更新。

QString QBarCategoryAxis::max() const

返回最大类别。

注： 属性 max 的获取函数。

另请参阅 setMax().

[signal] void QBarCategoryAxis::maxChanged(const QString &max)

当max 轴的值发生变化时会发出该信号。

注： 属性max 的通知信号。

QString QBarCategoryAxis::min() const

返回最小类别。

注： 属性 min 的获取函数。

另请参阅 setMin().

[signal] void QBarCategoryAxis::minChanged(const QString &min)

当min 轴的值发生变化时会发出该信号。

注： 属性min 的通知信号。

[signal] void QBarCategoryAxis::rangeChanged(const QString &min, const QString &max)

当min 或max 轴值发生变化时，会发出该信号。

void QBarCategoryAxis::remove(const QString &category)

从坐标轴中删除category 。删除当前设置坐标轴最大或最小值的类别会影响坐标轴范围。

void QBarCategoryAxis::replace(const QString &oldCategory, const QString &newCategory)

用newCategory 替换oldCategory 。如果轴上不存在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() 常量。

返回轴的类型。

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.