QBarCategoryAxis Class
QBarCategoryAxis 类为图表的坐标轴添加类别。更多
| Header： | #include <QBarCategoryAxis> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake： | QT += graphs |
| 在 QML 中： | BarCategoryAxis |
| 继承： | QAbstractAxis |
- 所有成员的列表，包括继承成员
- QBarCategoryAxis 是Qt Graphs C++ Classes for 2D 的一部分。
属性
- categories : QStringList
- count : const qsizetype
- max : QString
- min : QString
公共函数
| QBarCategoryAxis(QObject *parent = nullptr) | |
| virtual | ~QBarCategoryAxis() override |
| void | append(const QString &category) |
| void | append(const QStringList &categories) |
| QString | at(qsizetype index) const |
| QStringList | categories() |
| void | clear() |
| qsizetype | count() const |
| void | insert(qsizetype index, const QString &category) |
| QString | max() const |
| QString | min() const |
| void | remove(const QString &category) |
| void | remove(qsizetype index) |
| 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) |
属性文档
categories : QStringList
该属性用于保存轴的类别。
访问功能：
| QStringList | categories() |
| void | setCategories(const QStringList &categories) |
通知信号：
| void | categoriesChanged() |
[read-only] count : const qsizetype
该属性用于保存轴的类别数。
访问功能：
| qsizetype | count() const |
通知信号：
| void | countChanged() |
max : QString
此属性用于保存坐标轴上的最大值。
轴上的最大值。给定值应包含在categories 中。
访问功能：
通知信号：
| void | maxChanged(const QString &max) |
min : QString
此属性用于保存坐标轴上的最小值。
轴上的最小值。给定值应包含在categories 中。
访问功能：
Notifier 信号：
| void | minChanged(const QString &min) |
成员函数 文档
[explicit] QBarCategoryAxis::QBarCategoryAxis(QObject *parent = nullptr)
构造一个轴对象，它是parent 的子对象。
[override virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()
销毁轴对象。
[invokable] void QBarCategoryAxis::append(const QString &category)
将category 添加到坐标轴。坐标轴上的最大值将更改为与最后的category 匹配。如果之前未定义任何类别，轴上的最小值也将改为与category 匹配。
类别必须是有效的QString ，并且不能重复。重复的类别将不会被添加。
注： 可通过元对象系统和 QML 调用此功能。请参阅Q_INVOKABLE 。
[invokable] void QBarCategoryAxis::append(const QStringList &categories)
将categories 添加到坐标轴。轴上的最大值将改为与categories 中的最后一个类别相匹配。如果之前没有定义类别，轴上的最小值也将改为与categories 中的第一个类别相匹配。
类别必须是有效的QString ，且不能重复。重复的类别将不会被添加。
注： 可通过元对象系统和 QML 调用此函数。请参见Q_INVOKABLE 。
[invokable] QString QBarCategoryAxis::at(qsizetype index) const
返回index 中的类别。
注： 可通过元对象系统和 QML 调用此函数。请参见Q_INVOKABLE 。
QStringList QBarCategoryAxis::categories()
返回类别。
注： 属性类别的获取函数。
另请参阅 setCategories()。
[invokable] void QBarCategoryAxis::clear()
删除所有类别。将坐标轴范围的最大值和最小值设置为 QString::null。
注： 可通过元对象系统和 QML 调用此函数。请参见Q_INVOKABLE 。
qsizetype QBarCategoryAxis::count() const
返回类别数。
注： 属性计数的获取函数。
[invokable] void QBarCategoryAxis::insert(qsizetype index, const QString &category)
将category 插入index 处的坐标轴。category 必须是有效的QString ，且不能重复。如果category 被预置或附加到其他类别，轴上的最小值和最大值也会相应更新。
注： 可通过元对象系统和 QML 调用此功能。请参见Q_INVOKABLE 。
QString QBarCategoryAxis::max() const
返回最大类别。
注： 属性 max 的获取函数。
另请参阅 setMax().
QString QBarCategoryAxis::min() const
返回最小类别。
注： 属性 min 的获取函数。
另请参阅 setMin().
[invokable] void QBarCategoryAxis::remove(const QString &category)
从坐标轴中删除category 。删除当前在轴上设置最大值或最小值的类别会影响轴范围。
注： 可通过元对象系统和 QML 调用此函数。请参阅Q_INVOKABLE 。
[invokable] void QBarCategoryAxis::remove(qsizetype index)
从坐标轴index 上删除一个类别。删除当前设置轴上最大或最小值的类别会影响轴范围。
注： 可通过元对象系统和 QML 调用此函数。请参见Q_INVOKABLE 。
[invokable] void QBarCategoryAxis::replace(const QString &oldCategory, const QString &newCategory)
用newCategory 替换oldCategory 。如果轴上不存在oldCategory ，则不会执行任何操作。newCategory 必须是有效的QString ，且不能重复。如果最小或最大类别被替换，轴上的最小值和最大值也会相应更新。
注： 可通过元对象系统和 QML 调用此函数。请参见Q_INVOKABLE 。
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.
