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)

方法

append(list<real> values)
append(real value)
real at(int index)
clear()
int count()
deselectAllBars()
deselectBar(int index)
deselectBars(list<int> indexes)
insert(int index, real value)
bool isBarSelected(int index)
remove(int index, int count)
replace(int index, real value)
selectAllBars()
selectBar(int index)
selectBars(list<int> indexes)
setBarSelected(int index, bool selected)
real sum()
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 。

方法文档

append(list<real> values)

将values 指定的实数值列表追加到条形图集的末尾。

另请参阅 append()。

append(real value)

将value 指定的新值追加到条形集合的末尾。

real at(int index)

从条形集合中返回index 指定的值。如果索引超出范围，则返回 0.0。

clear()

删除条形集合中的所有值。

int count()

返回条形集的数值个数。

deselectAllBars()

取消选择条形集中的所有条形。

注意： 会发出BarSet::selectedBarsChanged 。

另请参阅 setBarSelected() 。

deselectBar(int index)

取消选择位于index 的条形图。

注：输出BarSet::selectedBarsChanged 。

另请参阅 setBarSelected()。

deselectBars(list<int> indexes)

将indexes 列表中传递的多个条形图标记为取消选择。

注：发出BarSet::selectedBarsChanged 。

另请参阅 setBarSelected()。

insert(int index, real value)

在index 指定的位置插入value 。插入值之后的值将上移一个位置。

另请参阅 remove() 。

bool isBarSelected(int index)

如果index 处的条形图属于所选条形图，则返回true ，否则返回false 。

注意： 如果使用 BarSet::setSelectedColor 指定了选定颜色，则将使用选定颜色绘制选定条形图。

另请参阅 selectedBars,setBarSelected() 和selectedColor 。

remove(int index, int count)

从index 指定的值开始，从条形图组中删除count 指定的数值个数。

如果省略count ，则只删除index 指定的值。

replace(int index, real value)

将value 指定的值添加到index 指定位置的条形图集中。

selectAllBars()

将集合中的所有条形图标记为选中。

注：输出BarSet::selectedBarsChanged 。

另请参阅 setBarSelected() 。

selectBar(int index)

将index 处的条形图标记为选中。

注：发出BarSet::selectedBarsChanged 。

另请参阅 setBarSelected()。

selectBars(list<int> indexes)

将indexes 列表中传递的多个条形图标记为选中。

注：发出BarSet::selectedBarsChanged 。

另请参阅 setBarSelected() 。

setBarSelected(int index, bool selected)

根据selected 的指定，将index 处的条形图标记为选中或取消选择。

注：如果指定了选定颜色，则使用选定颜色绘制选定条形图。发出BarSet::selectedBarsChanged 。

另请参阅 isBarSelected() 和selectedColor 。

real sum()

返回条形图组中所有值的总和。

toggleSelection(list<int> indexes)

将给定indexes 处的条形图选择状态更改为相反状态。

注：发出BarSet::selectedBarsChanged 。

另请参阅 setBarSelected() 。

© 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.