Back to Qt.io
Contact Us Blog Download Qt
本页内容

QBarCategoryAxis Class

QBarCategoryAxis 类用于在图表的坐标轴上添加分类。更多内容...

标题： #include <QBarCategoryAxis>
CMake： find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake： QT += graphs
在 QML 中： BarCategoryAxis
继承自： QAbstractAxis

公共类型

(since 6.11) enum class LabelPosition { Center, OnValue }

属性

公共函数

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)
QBarCategoryAxis::LabelPosition labelPosition() const
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 setLabelPosition(QBarCategoryAxis::LabelPosition position)
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 labelPositionChanged(QBarCategoryAxis::LabelPosition position)
void maxChanged(const QString &max)
void minChanged(const QString &min)

详细说明

QBarCategoryAxis 可配置为显示带有刻度、网格线和阴影的坐标轴线。类别会绘制在刻度之间。

成员类型文档

[since 6.11] enum class QBarCategoryAxis::LabelPosition

此枚举描述了类别标签的位置。

常量值描述
QBarCategoryAxis::LabelPosition::Center0标签居中显示在类别上。
QBarCategoryAxis::LabelPosition::OnValue1标签位于类别的上边缘。

该枚举类型在 Qt 6.11 中引入。

属性文档

categories : QStringList

该属性存储了坐标轴的类别。

访问函数：

QStringList categories()
void setCategories(const QStringList &categories)

通知信号：

void categoriesChanged()

[read-only] count : qsizetype

该属性存储了轴的类别数量。

访问函数：

qsizetype count() const

通知信号：

void countChanged()

[since 6.11] labelPosition : LabelPosition

该属性用于确定类别标签的位置。当轴的起始端和末端标签采用“按值对齐”方式定位时，可能会与其他轴的标签发生重叠。

该枚举在 Qt 6.11 中引入。

访问函数：

QBarCategoryAxis::LabelPosition labelPosition() const
void setLabelPosition(QBarCategoryAxis::LabelPosition position)

通知器信号：

void labelPositionChanged(QBarCategoryAxis::LabelPosition position)

max : QString

该属性表示轴上的最大值。

该轴上的最大值。给定的值应包含在categories 中。

访问函数：

QString max() const
void setMax(const QString &max)

通知信号：

void maxChanged(const QString &max)

min : QString

该属性存储了轴上的最小值。

轴上的最小值。给定的值应包含在categories 中。

访问函数：

QString min() const
void setMin(const QString &min)

通知信号：

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()

返回类别。

注意： 这是属性 categories 的获取器 函数。

另请参阅 setCategories()。

[invokable] void QBarCategoryAxis::clear()

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

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

qsizetype QBarCategoryAxis::count() const

返回类别数量。

注意： 这是属性 count 的获取 函数。

[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)

将oldCategory 替换为newCategory 。如果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() 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.