BarSet QML Type
代表条形图中的一组条形。更多
| Import Statement: | import QtGraphs |
| In C++: | QBarSet |
- 所有成员的列表，包括继承成员
- BarSet 是Qt Graphs QML Types for 2D 的一部分。
属性
- 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)
详细说明
条形集包含每个类别的一个数据值。假设数据集的第一个值属于第一个类别，第二个值属于第二个类别，以此类推。如果数据集的数据值少于类别数，则缺失的数据值会被认为位于数据集的末尾。对于位于集合中间的缺失值，则使用数值 0。不显示零值集的标签。
另请参阅 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。如果在零和最高值之间的任何 x 坐标上缺少一个点，则该点的值为零。
例如，以下条形集的值相等：
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)
将value 插入index 指定的位置。插入值后面的值向上移动一个位置。
另请参见 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.
