BarSet QML Type
表示条形图中的一组条形。更多...
| Import Statement: | import QtGraphs |
| In C++: | QBarSet |
- 所有成员列表，包括继承的成员
- BarSet 是Qt Graphs 2D QML 类型的一部分。
属性
- borderColor : color
- borderWidth : real
- color : color
- count : int
- label : string
- labelColor : color
- selectedBars : list
- selectedColor : color
- values : list<variant>
信号
- borderColorChanged(color)
- borderWidthChanged(real width)
- colorChanged(color)
- countChanged()
- labelChanged()
- labelColorChanged(color)
- selectedBarsChanged(list<int> indexes)
- selectedColorChanged(color color)
- update()
- updatedBars()
- valueAdded(int index, int count)
- valueChanged(int index)
- valueRemoved(int index, int count)
- valuesAdded(int index, int count)
- valuesChanged()
- valuesRemoved(int index, int count)
方法
- void append(list<real> values)
- void append(real value)
- real at(int index)
- void clear()
- int count()
- void deselectAllBars()
- void deselectBar(int index)
- void deselectBars(list<int> indexes)
- void insert(int index, real value)
- bool isBarSelected(int index)
- void remove(int index, int count)
- void replace(int index, real value)
- void selectAllBars()
- void selectBar(int index)
- void selectBars(list<int> indexes)
- void setBarSelected(int index, bool selected)
- real sum()
- void toggleSelection(list<int> indexes)
详细说明
一个条形图数据集包含每个类别的单个数据值。数据集中的第一个值被视为属于第一个类别，第二个值属于第二个类别，依此类推。如果数据集中的值个数少于类别数，则缺失的值被视为位于数据集的末尾。 对于位于数据集中间的缺失值，将使用数值零来表示。零值数据集的标签不会显示。
另请参阅 BarSeries 。
属性文档
borderColor : color
已设置的条形边框颜色。
borderWidth : real
默认情况下，宽度为 -1，这意味着边框宽度由主题决定。
color : color
该条形图组的填充颜色。
count : int [read-only]
条形图数据集中的值个数。
label : string
酒吧套装的标签。
labelColor : color
该条形图组的文本（标签）颜色。
selectedBars : list [read-only]
当前选中的柱状图的索引。
selectedColor : color
所选集合的填充颜色。
values : list<variant>
条形集的值。您可以将real 或point 类型的列表作为值进行设置。
若将实数类型的列表作为值，则这些数值将直接定义条形集的数值。
如果将点类型的列表作为值设置，则该点的 x 坐标即表示其在柱形图集中的以零为起点的索引。 条形集的大小等于最大的 x 坐标值 + 1。如果 0 到最大值之间的任何 x 坐标处缺少点，则该点取值为 0。
例如，以下柱状图集的数值相同：
myBarSet1.values = [5, 0, 1, 5];
myBarSet2.values = [Qt.point(0, 5), Qt.point(2, 1), Qt.point(3, 5)];信号文档
borderColorChanged(color)
当条形图集的边框颜色变为color 时，会发出此信号。
注意： 相应的处理程序 为onBorderColorChanged 。
borderWidthChanged(real width)
当条形图集的边框宽度发生变化时，会触发此信号。新宽度为width 。
注意： 相应的处理程序 是onBorderWidthChanged 。
colorChanged(color)
当条形集的填充颜色变为color 时，将发出此信号。
注意： 相应的处理程序 为onColorChanged 。
countChanged()
当条形集的值计数发生变化时，会发出此信号。
注意： 相应的处理程序 为onCountChanged 。
labelChanged()
当条形集的标签发生变化时，会触发此信号。
注意： 相应的处理程序 为onLabelChanged 。
另请参阅 label 。
labelColorChanged(color)
当条形集的文本（标签）颜色变为color 时，会发出此信号。
注意： 相应的处理程序 为onLabelColorChanged 。
selectedBarsChanged(list<int> indexes)
当选中的柱状图发生变化时，会触发此信号。indexes 是一个包含选中柱状图索引的列表。
注意： 相应的处理程序 为onSelectedBarsChanged 。
selectedColorChanged(color color)
当选中的柱状图颜色发生变化时，会触发此信号。新颜色为color 。
注意： 相应的处理程序 为onSelectedColorChanged 。
update()
当条形集更新时，会发出此信号。
注意： 相应的处理程序 为onUpdate 。
updatedBars()
当该集合中的柱状图更新时，会触发此信号。
注意： 相应的处理程序 为onUpdatedBars 。
valueAdded(int index, int count)
当向条形数据集添加新值时，会触发此信号。index 表示第一个插入值的位置，count 表示插入的值个数。
注意： 对应的处理程序 为onValueAdded 。
valueChanged(int index)
当index 指定的位置处的值发生更改时，会触发此信号。
注意： 相应的处理程序 为onValueChanged 。
valueRemoved(int index, int count)
当从条形数据集中移除值时，会触发此信号。index 表示第一个被移除值的位置，count 表示被移除的值个数。
注意： 对应的处理程序 为onValueRemoved 。
valuesAdded(int index, int count)
当向条形数据集添加新值时，会触发此信号。index 表示第一个插入值的位置，count 表示插入的值个数。
注意： 对应的处理程序 为onValuesAdded 。
valuesChanged()
当柱状图数据发生变化时，会触发此信号。
注意： 相应的处理程序 为onValuesChanged 。
valuesRemoved(int index, int count)
当从条形数据集移除值时，会触发此信号。index 表示第一个被移除值的位置，count 表示被移除的值个数。
注意： 相应的处理程序 是onValuesRemoved 。
方法文档
void append(list<real> values)
将由values 指定的实数列表追加到条形集合的末尾。
另请参阅 append ()。
void append(real value)
将value 指定的新值追加到柱形数据集的末尾。
real at(int index)
从条形图集合中返回由index 指定的值。如果索引超出范围，则返回0.0。
void clear()
从集合中移除所有值。
int count()
返回条形集中的值个数。
void deselectAllBars()
取消选中该集合中的所有柱状图。
注意：会触发 BarSet::selectedBarsChanged 。
另请参阅 setBarSelected()。
void deselectBar(int index)
取消选中位于index 的条形图。
注意：会触发 BarSet::selectedBarsChanged 。
另请参阅 setBarSelected()。
void deselectBars(list<int> indexes)
将indexes 列表中已通过的多个条目标记为“未选中”。
注意：会触发 BarSet::selectedBarsChanged事件 。
另请参阅 setBarSelected()。
void insert(int index, real value)
在index 指定的位置插入value 。插入值之后的值将向上移动一位。
另请参阅 remove()。
bool isBarSelected(int index)
如果位于给定坐标 `index ` 的柱形图属于选中的柱形图之一，则返回 `true `；否则返回 `false `。
注意： 如果通过 BarSet::setSelectedColor 指定了选中颜色，则选中的 柱状图将使用该颜色绘制。
另请参阅 selectedBars 、setBarSelected() 和selectedColor 。
void remove(int index, int count)
从以index 指定的值开始的条形集合中，移除由count 指定的数量的值。
如果省略count ，则仅移除由index 指定的值。
void replace(int index, real value)
将value 指定的值添加到位于index 指定位置的条形上。
void selectAllBars()
将集合中的所有小节标记为已选中。
注意：会触发 BarSet::selectedBarsChanged 。
另请参阅 setBarSelected()。
void selectBar(int index)
将位于index 的条形标记为已选中。
注意：会发出 BarSet::selectedBarsChanged 信号。
另请参阅 setBarSelected()。
void selectBars(list<int> indexes)
将indexes 列表中已通过的多条小节标记为已选中。
注意：会触发 BarSet::selectedBarsChanged事件 。
另请参阅 setBarSelected()。
void setBarSelected(int index, bool selected)
根据selected 的设置，将位于index 处的条形标记为已选中或未选中。
注意： 如果指定了选中颜色，则选中的 条形将使用该颜色绘制。触发BarSet::selectedBarsChanged 。
另请参阅 isBarSelected() 和selectedColor 。
real sum()
返回条形图集中所有值的总和。
void toggleSelection(list<int> indexes)
将指定indexes 处的小节的选择状态更改为相反的状态。
注意：会触发 BarSet::selectedBarsChanged事件 。
另请参阅 setBarSelected()。
© 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.
