QBarSet Class
QBarSet 类表示条形图中的一组条形。更多
| Header： | #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 C++ Classes for 2D 的一部分。
属性
|
|
公共功能
| 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) |
详细说明
条形集包含每个类别的一个数据值。假定数据集的第一个值属于第一个类别，第二个值属于第二个类别，以此类推。如果数据集的数据值少于类别数，则缺失的数据值会被认为位于数据集的末尾。对于位于集合中间的缺失值，则使用数值 0。不显示零值集的标签。
另请参阅 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 : const 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 : const QList<qsizetype>
该属性保存当前所选条形的索引。
访问功能：
| 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) |
Notifier 信号：
| 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
返回条形图集的填充颜色。
注： 属性颜色的获取函数。
另请参阅 setColor().
[invokable] qsizetype QBarSet::count() const
返回条形集合中数值的个数。
注： 可通过元对象系统和 QML 调用此函数。请参阅Q_INVOKABLE 。
注： 属性计数的获取函数。
[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)
将value 插入index 指定的位置。插入值后面的值会上移一个位置。
注： 可通过元对象系统和 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
返回条形图组的标签。
注： 属性标签的获取函数。
另请参阅 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。
© 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.
