QBarSet Class
QBarSet 类表示条形图中的一组条形。更多内容...
| 头文件： | #include <QBarSet> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake： | QT += graphs |
| 在 QML 中： | BarSet |
| 继承自： | QObject |
- 所有成员列表，包括继承的成员
- QBarSet 属于Qt Graphs 的2D C++ 类库。
属性
|
|
公共函数
| QBarSet(const QString &label, QObject *parent = nullptr) | |
| virtual | ~QBarSet() override |
| void | append(const QList<qreal> &values) |
| void | append(qreal value) |
| qreal | at(qsizetype index) const |
| QColor | borderColor() const |
| qreal | borderWidth() const |
| void | clear() |
| QColor | color() const |
| qsizetype | count() const |
| void | deselectAllBars() |
| void | deselectBar(qsizetype index) |
| void | deselectBars(const QList<qsizetype> &indexes) |
| void | insert(qsizetype index, qreal value) |
| bool | isBarSelected(qsizetype index) const |
| QString | label() const |
| QColor | labelColor() const |
| void | remove(qsizetype index, qsizetype count = 1) |
| void | replace(qsizetype index, qreal value) |
| void | selectAllBars() |
| void | selectBar(qsizetype index) |
| void | selectBars(const QList<qsizetype> &indexes) |
| QList<qsizetype> | selectedBars() const |
| QColor | selectedColor() const |
| void | setBarSelected(qsizetype index, bool selected) |
| void | setBorderColor(QColor color) |
| void | setBorderWidth(qreal borderWidth) |
| void | setColor(QColor color) |
| void | setLabel(const QString &label) |
| void | setLabelColor(QColor color) |
| void | setSelectedColor(QColor color) |
| void | setValues(const QVariantList &values) |
| qreal | sum() const |
| void | toggleSelection(const QList<qsizetype> &indexes) |
| QVariantList | values() const |
| QBarSet & | operator<<(qreal value) |
| qreal | operator[](qsizetype index) const |
信号
| void | borderColorChanged(QColor color) |
| void | borderWidthChanged(qreal width) |
| void | colorChanged(QColor color) |
| void | countChanged() |
| void | labelChanged() |
| void | labelColorChanged(QColor color) |
| void | selectedBarsChanged(const QList<qsizetype> &indexes) |
| void | selectedColorChanged(QColor color) |
| void | update() |
| void | updatedBars() |
| void | valueAdded(qsizetype index, qsizetype count) |
| void | valueChanged(qsizetype index) |
| void | valueRemoved(qsizetype index, qsizetype count) |
| void | valuesAdded(qsizetype index, qsizetype count) |
| void | valuesChanged() |
| void | valuesRemoved(qsizetype index, qsizetype count) |
详细说明
一个条形数据集包含每个类别的一个数据值。数据集中的第一个值被视为属于第一个类别，第二个值属于第二个类别，依此类推。如果数据集中的值少于类别数，则缺失的值被视为位于数据集的末尾。 对于位于数据集中间的缺失值，将使用数值零来表示。零值数据集的标签不会显示。
另请参阅 QBarSeries 。
属性文档
borderColor : QColor
该属性用于设置条形集的边框颜色。
访问函数：
| QColor | borderColor() const |
| void | setBorderColor(QColor color) |
通知信号：
| void | borderColorChanged(QColor color) |
borderWidth : qreal
该属性用于指定边框线的宽度。默认情况下，宽度为 -1，这意味着边框宽度由主题决定。
访问函数：
| qreal | borderWidth() const |
| void | setBorderWidth(qreal borderWidth) |
通知信号：
| void | borderWidthChanged(qreal width) |
color : QColor
该属性存储条形图集的填充颜色。
访问函数：
通知信号：
| void | colorChanged(QColor color) |
[read-only] count : qsizetype
该属性存储条形集中的值个数。
访问函数：
| qsizetype | count() const | [see note below] |
注意： 可通过元对象系统和QML调用此 函数。参见Q_INVOKABLE 。
通知器信号：
| void | countChanged() |
label : QString
该属性存储条形集的标签。
访问函数：
通知信号：
| void | labelChanged() |
labelColor : QColor
该属性用于设置条形集的文本（标签）颜色。
访问函数：
| QColor | labelColor() const |
| void | setLabelColor(QColor color) |
通知信号：
| void | labelColorChanged(QColor color) |
[read-only] selectedBars : QList<qsizetype>
该属性存储当前所选K线的索引。
访问函数：
| QList<qsizetype> | selectedBars() const |
通知信号：
| void | selectedBarsChanged(const QList<qsizetype> &indexes) |
selectedColor : QColor
该属性存储所选集合的填充颜色。
访问函数：
| QColor | selectedColor() const |
| void | setSelectedColor(QColor color) |
通知信号：
| void | selectedColorChanged(QColor color) |
values : QVariantList
该属性存储条形集的值。
如果将实数类型的列表作为值进行设置，它们将直接定义条形集的值。
如果将点类型的列表作为值设置，则点的 x 坐标指定了它在条形集中的以零为起点的索引。 条形集的大小为最大的 x 坐标值 + 1。如果零到最大值之间的任何 x 坐标处缺少点，则该坐标处的值将设为零。
访问函数：
| QVariantList | values() const |
| void | setValues(const QVariantList &values) |
通知信号：
| void | valuesChanged() |
成员函数文档
[explicit] QBarSet::QBarSet(const QString &label, QObject *parent = nullptr)
创建一个带有标签“label ”且父元素为“parent ”的条形图集。
[override virtual noexcept] QBarSet::~QBarSet()
移除该条形图集。
[invokable] void QBarSet::append(const QList<qreal> &values)
将由 `values ` 指定的实数列表追加到条形集合的末尾。
注意： 可通过元对象系统和 QML 调用此 函数。参见Q_INVOKABLE 。
另请参阅 append ()。
[invokable] void QBarSet::append(qreal value)
将由value 指定的新值追加到条形集的末尾。
注意： 可通过元对象系统和 QML 调用此 函数。参见Q_INVOKABLE 。
[invokable] qreal QBarSet::at(qsizetype index) const
从条形图集中返回由index 指定的值。如果索引超出范围，则返回0.0。
注意： 可通过元对象系统和 QML 调用此 函数。参见Q_INVOKABLE 。
QColor QBarSet::borderColor() const
返回条形图集的线条颜色。
注意： 这是 borderColor 属性的获取 函数。
另请参阅 setBorderColor()。
[invokable] void QBarSet::clear()
从集合中移除所有值。
注意： 可通过元对象系统和 QML 调用此 函数。请参阅Q_INVOKABLE 。
QColor QBarSet::color() const
返回条形图集的填充颜色。
注意： 这是 color 属性的获取 函数。
另请参阅 setColor()。
[invokable] qsizetype QBarSet::count() const
返回条形集中的值个数。
注意： 可通过元对象系统和 QML 调用此 函数。参见Q_INVOKABLE 。
注意： 这是属性 count 的获取 函数。
[invokable] void QBarSet::deselectAllBars()
取消选中该集合中的所有柱形图。
注意：会触发 QBarSet::selectedBarsChanged事件 。
注意： 可通过元对象系统和 QML 调用此 函数。参见Q_INVOKABLE 。
另请参阅 setBarSelected()。
[invokable] void QBarSet::deselectBar(qsizetype index)
取消选中位于index 的条形图。
注意：会触发 QBarSet::selectedBarsChanged事件 。
注意： 可通过元对象系统和 QML 调用此 函数。参见Q_INVOKABLE 。
另请参阅 setBarSelected()。
[invokable] void QBarSet::deselectBars(const QList<qsizetype> &indexes)
将indexes 列表中已通过的多条条目标记为未选中。
注意：会触发 QBarSet::selectedBarsChanged事件 。
注意： 可通过元对象系统以及从 QML 调用此 函数。参见Q_INVOKABLE 。
另请参阅 setBarSelected()。
[invokable] void QBarSet::insert(qsizetype index, qreal value)
在index 指定的位置插入value 。插入值之后的值将向上移动一个位置。
注意： 可通过元对象系统和 QML 调用此 函数。参见Q_INVOKABLE 。
另请参阅 remove()。
[invokable] bool QBarSet::isBarSelected(qsizetype index) const
如果位于给定坐标 `index ` 的柱形图属于选定柱形图，则返回 `true `；否则返回 `false `。
注意： 如果已通过 `QBarSet::setSelectedColor` 指定了选定颜色，则选定 柱状图将使用该颜色绘制。
注意： 可通过元对象系统和 QML 调用此 函数。参见Q_INVOKABLE 。
另请参阅 selectedBars()、setBarSelected() 以及setSelectedColor()。
QString QBarSet::label() const
返回条形图集的标签。
注意： 这是属性 label 的获取 函数。
另请参阅 setLabel()。
QColor QBarSet::labelColor() const
返回条形图集的文本颜色。
注意： 这是 labelColor 属性的获取 函数。
另请参阅 setLabelColor()。
[invokable] void QBarSet::remove(qsizetype index, qsizetype count = 1)
从以 `index` 指定的值开头的条形集合中，移除由 `count ` 指定的数量的值。
注意： 可通过元对象系统和 QML 调用此 函数。参见Q_INVOKABLE 。
另请参阅 insert()。
[invokable] void QBarSet::replace(qsizetype index, qreal value)
将由 `value ` 指定的值添加到位于 `index` 指定位置的条形上。
注意： 可以通过元对象系统和 QML 调用此 函数。请参阅Q_INVOKABLE 。
[invokable] void QBarSet::selectAllBars()
将集合中的所有小节标记为已选中。
注意：会触发 QBarSet::selectedBarsChanged 。
注意： 可通过元对象系统和 QML 调用此 函数。参见Q_INVOKABLE 。
另请参阅 setBarSelected()。
[invokable] void QBarSet::selectBar(qsizetype index)
将位于index 的条形标记为已选中。
注意：会触发 QBarSet::selectedBarsChanged 。
注意： 可通过元对象系统以及从 QML 中调用此 函数。参见Q_INVOKABLE 。
另请参阅 setBarSelected()。
[invokable] void QBarSet::selectBars(const QList<qsizetype> &indexes)
将indexes 列表中经过的多个小节标记为已选中。
注意：会触发 QBarSet::selectedBarsChanged事件 。
注意： 可通过元对象系统和 QML 调用此 函数。参见Q_INVOKABLE 。
另请参阅 setBarSelected()。
QList<qsizetype> QBarSet::selectedBars() const
返回一个标记为“已选中”的柱状图列表。
注意： 这是 selectedBars 属性的获取函数 。
另请参阅 setBarSelected()。
[signal] void QBarSet::selectedBarsChanged(const QList<qsizetype> &indexes)
当选中的柱状图发生变化时，会触发此信号。indexes 是一个包含选中柱状图索引的列表。
注意： 这是属性 `selectedBars`的通知 信号。
QColor QBarSet::selectedColor() const
返回所选条形图的颜色。
这是被标记为“选中”的条形图的填充（笔刷）颜色。如果未指定，则使用QBarSet::color 的值作为默认值。
注意： 这是 selectedColor 属性的获取 函数。
另请参阅 setSelectedColor() 和color 。
[invokable] void QBarSet::setBarSelected(qsizetype index, bool selected)
根据selected 的设置，将位于index 处的条形标记为已选中或未选中。
注意： 如果指定了选中颜色，则选中的 条形将使用该颜色绘制。会触发QBarSet::selectedBarsChanged 事件。
注意： 可通过元对象系统和 QML 调用此 函数。参见Q_INVOKABLE 。
另请参阅 isBarSelected() 和setSelectedColor()。
void QBarSet::setBorderColor(QColor color)
将条形图集的线条颜色设置为color 。
注意： 这是属性 `borderColor`的设置 函数。
另请参阅 borderColor()。
void QBarSet::setColor(QColor color)
将条形图集的填充颜色设置为color 。
注意： 这是属性color 的设置 函数。
另请参阅 color()。
void QBarSet::setLabel(const QString &label)
将label 设置为条形集的新标签。
注意： 这是属性label 的设置 函数。
另请参阅 label()。
void QBarSet::setLabelColor(QColor color)
设置条形集color 的文本颜色。
注意： 这是属性 `labelColor`的设置 函数。
另请参阅 labelColor()。
void QBarSet::setSelectedColor(QColor color)
设置所选小节的color 属性。
注意： 这是属性selectedColor 的设置 函数。
另请参阅 selectedColor 。
[invokable] qreal QBarSet::sum() const
返回条形集中的所有值的总和。
注意： 可以通过元对象系统和 QML 调用此 函数。请参阅Q_INVOKABLE 。
[invokable] void QBarSet::toggleSelection(const QList<qsizetype> &indexes)
将指定indexes 处的音符选中状态更改为相反状态。
注意：会触发 QBarSet::selectedBarsChanged事件 。
注意： 可通过元对象系统或从 QML 调用此 函数。参见Q_INVOKABLE 。
另请参阅 setBarSelected()。
[signal] void QBarSet::update()
当条形集更新时，会发出此信号。
[signal] void QBarSet::updatedBars()
当该集合中的条形图更新时，会发出此信号。
[signal] void QBarSet::valueAdded(qsizetype index, qsizetype count)
当向条形数据集添加新值时，会发出此信号。index 表示首个插入值的位置，count 表示插入的值个数。
[signal] void QBarSet::valueChanged(qsizetype index)
当index 指定的位置处的值发生变化时，会触发此信号。
另请参阅 at()。
[signal] void QBarSet::valueRemoved(qsizetype index, qsizetype count)
当从条形数据集中共移除值时，会发出此信号。index 表示第一个被移除值的位置，count 表示被移除的值个数。
[signal] void QBarSet::valuesAdded(qsizetype index, qsizetype count)
当向条形集合中添加新值时，会发出此信号。index 表示第一个插入值的位置，count 表示插入的值个数。
[signal] void QBarSet::valuesRemoved(qsizetype index, qsizetype count)
当从柱状图集合中移除数值时，会发出此信号。index 表示第一个被移除数值的索引，count 表示被移除数值的个数。
另请参阅 remove()。
QBarSet &QBarSet::operator<<(qreal value)
一个便捷操作符，用于将value 指定的实数值追加到条形集合的末尾。
另请参阅 append()。
qreal QBarSet::operator[](qsizetype index) const
返回由index 指定的柱形图集的值。如果索引超出范围，则返回0.0。
© 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.
