柱形集 QML 类型

表示柱形图中的一组柱子。更多...

导入语句	import QtGraphs
实例化	QBarSet
状态	技术预览

所有成员的列表，包括继承的成员
柱形集是 Qt 图形 2D QML 类型的一部分。

属性

borderColor : 颜色
borderWidth : 实数
color : 颜色
count : 整数
label : 字符串
labelColor : 颜色
selectedBars : 列表
values : QVariant 列表

信号

valueChanged(int index)
valuesAdded(int index, int count)
valuesRemoved(int index, int count)

方法

append(real value)
at(int index)
remove(int index, int count)
replace(int index, real value)

详细说明

柱形集包含每个类别的每个数据值。一个集合的第一个值被认为属于第一个类别，第二个值属于第二个类别，依此类推。如果一个集合的值比类别的数量少，假设缺少的值位于集合的末尾。对于集合中间的缺少值，使用数值零。对于零值集合的标签不显示。

参见 AbstractBarSeries 和 BarSeries。

属性文档

borderColor : 颜色

柱形集的边框颜色。

borderWidth : 实数

默认情况下，宽度是 -1，表示边框宽度由主题定义。

color : 颜色

柱形集的填充颜色。

count : int [只读]

柱状图集中值的数量。

label : string

柱状图集的标签。

labelColor : color

柱状图集文本（标签）的颜色。

selectedBars : list [只读]

当前选中的柱状图的索引。

values : QVariantList

柱状图集的值。您可以将real或point类型的列表作为值设置。

如果将实数类型的列表设置为值，它们直接定义柱状图集的值。

如果将点类型的列表设置为值，则点的x坐标指定其在柱状图集中的基于0的索引。柱状图集的大小是最高x坐标值+1。如果任何x坐标在零和最高值之间缺失，则其值为零。

例如，以下柱状图集具有相等的值

myBarSet1.values = [5, 0, 1, 5];
myBarSet2.values = [Qt.point(0, 5), Qt.point(2, 1), Qt.point(3, 5)];

信号文档

valueChanged(int index)

当由index指定的位置的值被修改时，发出此信号。

相应的信号处理程序为onValueChanged。

注意: 相应的处理程序为onValueChanged。

valuesAdded(int index, int count)

向柱状图集添加新值时发出此信号。index指示第一个插入值的定位，count是插入值的数量。

相应的信号处理程序为onValuesAdded。

注意: 相应的处理程序为onValuesAdded。

valuesRemoved(int index, int count)

从柱状图集移除值时发出此信号。index指示第一个被移除值的定位，count是移除值的数量。

相应的信号处理程序为onValuesRemoved。

注意: 相应的处理程序为onValuesRemoved。

方法文档

append(real value)

将由value指定的新值追加到柱状图集的末尾。

at(int index)

从柱状图集中返回由index指定的值。如果索引超出范围，则返回0.0。

remove(int index, int count)

从由index指定的值开始移除柱状图集中指定数量的值。

如果您省略count，则只移除由index指定的值。

replace(int index, real value)

将value指定的值添加到由index指定的柱状图集位置。