AbstractBarSeries QML 类型

所有柱形系列类型的抽象父类型。更多...

导入语句	import QtGraphs
实例化	QAbstractBarSeries
继承	AbstractSeries
继承自	BarSeries
状态	技术预览

所有成员列表，包括继承的成员
AbstractBarSeries 属于 Qt 图表 QML 2D 类型。

属性

barWidth : real
count : int
labelsAngle : real
labelsFormat : string
labelsPosition : enumeration
labelsPrecision : real
labelsVisible : bool

信号

barsetsAdded()
barsetsRemoved()
clicked(int index, BarSet barset)
doubleClicked(int index, BarSet barset)
hovered(bool status, int index, BarSet barset)
pressed(int index, BarSet barset)
released(int index, BarSet barset)

方法

BarSet append(string label, VariantList values)
BarSet at(int index)
clear()
BarSet insert(int index, string label, VariantList values)
bool remove(BarSet barset)

详细描述

在柱状图中，柱子由包含每个类别一个数据值的柱集定义。柱子的位置由类别指定，其高度由数据值指定。包含多个柱集的柱系列将属于同一类别的柱子组合在一起。柱子的显示方式由用于创建柱状图的此类子类决定。

属性文档

barWidth : real

宽度单位是x轴的单位。柱条的最小宽度为零，并视为负数。将宽度设置为零意味着不管x轴的比例如何，屏幕上柱条的宽度都是一像素。宽度大于零的柱条使用x轴比例进行缩放。

默认情况下，barWidth为0.5（柱条将占据可用宽度的50%）。有效值范围从0.0（0%）到1.0（100%）。

注意：当与BarSeries类型一起使用时，此值指定一组柱条的宽度，而不是单个柱条的宽度。

count : int [只读]

柱系中柱条组的数量。

labelsAngle : real

单位标签的角度，单位为度。

labelsFormat : string

显示柱系中标签使用的格式。

另请参阅QAbstractBarSeries::labelsFormat、labelsVisible和labelsPosition。

labelsPosition : enumeration

数据值标签的位置

常量	描述
`AbstractBarSeries.LabelsCenter`	标签位于柱条中心。
`AbstractBarSeries.LabelsInsideEnd`	标签位于柱条顶部内部。
`AbstractBarSeries.LabelsInsideBase`	标签位于柱条底部内部。
`AbstractBarSeries.LabelsOutsideEnd`	标签位于柱条顶部外部。

另请参阅labelsVisible和labelsFormat。

labelsPrecision : real

在值标签中显示的最大有效数字。

默认值为6。

labelsVisible : bool

柱系中文本标签的可见性。

信号文档

barsetsAdded()

当组添加到系列时发出此信号。

对应的信号处理器是onBarsetsAdded。

注意：相应的处理器是onBarsetsAdded。

barsetsRemoved()

当从系列中删除组时发出此信号。

对应的信号处理器是onBarsetsRemoved。

注意：相应的处理器是onBarsetsRemoved。

clicked(int index, BarSet barset)

当用户点击由index指定的barset中指定的柱条时，会发出此信号。

对应的信号处理器是onClicked。

注意：相应的处理器是onClicked。

doubleClicked(int index, BarSet barset)

当用户双击由index指定的barset中指定的柱条时，会发出此信号。

对应的信号处理器是onDoubleClicked。

注意：相应的处理器是onDoubleClicked。

hovered(bool status, int index, BarSet barset)

当鼠标悬停在上文指定的由 index 指定条形图集中的条形图上时，会发出此信号。当鼠标悬停于条形图上时，status 变为 true，当鼠标再次移开后，它变为 false。

相应的信号处理程序是 onHovered。

注意：相应的处理程序是 onHovered。

pressed(int index, BarSet barset)

当用户点击在由 index 指定条形图集中的条形图，并且按住鼠标按钮时，会发出此信号。

相应的信号处理程序是 onPressed。

注意：相应的处理程序是 onPressed。

released(int index, BarSet barset)

当用户释放指定为 index 且位于 barset 条形集中的条形图上的鼠标按钮时，会发出此信号。

相应的信号处理程序是 onReleased。

注意：相应的处理程序是 onReleased。

方法文档

BarSet append(string label, VariantList values)

将带有 label 和 values 的新条形集合添加到索引。 values 是一个实数值列表。

例如

myBarSeries.append("set 1", [0, 0.2, 0.2, 0.5, 0.4, 1.5, 0.9]);

BarSet at(int index)

返回索引处的条形集合。如果索引无效，则返回 null。

clear()

从系列中删除所有条形集合。

BarSet insert(int index, string label, VariantList values)

向索引处添加带有 label 和 values 的新条形集合。values 可以是实数值列表或 XYPoint 类型列表。

如果索引值小于或等于零，则新条形集合并置到条形序列中。如果索引值等于或大于条形序列中条形集的数量，则新条形集合附加到条形序列中。

另请参阅：append()。

bool remove(BarSet barset)

从系列中删除指定的 barset 条形集合。如果成功，则返回 true，否则返回 false。