QBarCategoryAxis Class
QBarCategoryAxis 类可为图表的坐标轴添加类别。更多内容...
| Header: | #include <QBarCategoryAxis> |
| In QML: | BarCategoryAxis |
| Inherits: | QAbstractAxis |
| Status: | Deprecated |
该类已弃用。我们强烈建议在新代码中不要使用它。
属性
- categories : QStringList
- count : int
- max : QString
- min : QString
公共函数
| 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 可配置为显示带有刻度、网格线和阴影的坐标轴线。类别图标绘制在刻度之间。它也可与线形数据系列配合使用，如“带小部件的图表”示例库中所示。
以下代码演示了如何使用 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 : int
该属性存储了轴的类别数量。
访问函数：
| int | count() const |
通知信号：
| void | countChanged() |
max : QString
该属性表示轴上的最大值。
访问函数：
通知信号：
| void | maxChanged(const QString &max) |
min : QString
该属性存储了该轴上的最小值。
访问函数：
通知信号：
| 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()
返回类别。
注意： 这是属性 categories 的获取器 函数。
另请参阅 setCategories()。
[signal] void QBarCategoryAxis::categoriesChanged()
当坐标轴的类别发生变化时，会发出此信号。
注意： 这是属性categories的通知器 信号。
[invokable] void QBarCategoryAxis::clear()
删除所有类别。将坐标轴范围的最大值和最小值设置为 QString::null。
注意： 可通过元对象系统和 QML 调用此 函数。请参阅Q_INVOKABLE 。
int QBarCategoryAxis::count() const
返回类别数量。
注意： 这是属性 count 的获取器 函数。
[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)
将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。
返回轴的类型。
© 2026 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.
