AbstractBarSeries QML Type

所有条形图系列类型的抽象父类型。更多

• 所有成员（包括继承成员）的列表

属性

• axisX : AbstractAxis
• axisXTop : AbstractAxis
• axisY : AbstractAxis
• axisYRight : AbstractAxis
• 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)
• void clear()
• BarSet insert(int index, string label, VariantList values)
• bool remove(BarSet barset)

详细说明

在条形图中，条形被定义为条形集，每个类别包含一个数据值。条形图的位置由类别指定，高度由数据值指定。包含多个条形集的条形系列将属于同一类别的条形组合在一起。条形图的显示方式由创建条形图时选择的类型决定：BarSeries,StackedBarSeries,PercentBarSeries,HorizontalBarSeries,HorizontalStackedBarSeries 或HorizontalPercentBarSeries 。

如果使用ValueAxis 类型而不是BarCategoryAxis 类型作为主条形图坐标轴，条形图将围绕类别的索引值分组。

下面的 QML 代码片段展示了如何使用BarSeries 和BarCategoryAxis 类型创建一个简单的条形图：

ChartView {
    title: "Bar Chart"
    anchors.fill: parent
    legend.alignment: Qt.AlignBottom
    antialiasing: true

    BarSeries {
        id: mySeries
        axisX: BarCategoryAxis { categories: ["2007", "2008", "2009", "2010", "2011", "2012" ] }
        BarSet { label: "Bob"; values: [2, 2, 3, 4, 5, 6] }
        BarSet { label: "Susan"; values: [5, 1, 2, 4, 1, 7] }
        BarSet { label: "James"; values: [3, 5, 8, 13, 5, 8] }
    }
}

属性文档

axisX : AbstractAxis

用于系列的 X 轴。如果不定义 axisX 和axisXTop ，则会为系列创建BarCategoryAxis 。

另请参阅 axisXTop 。

axisXTop : AbstractAxis

用于系列的 x 轴，绘制在图表视图的顶部。

另请参阅 axisX 。

axisY : AbstractAxis

用于系列的 Y 轴。如果不定义 axisY 和axisYRight ，则会为系列创建ValueAxis 。

另请参阅 axisYRight 。

axisYRight : AbstractAxis

用于系列的 Y 轴，绘制在图表视图的右侧。

另请参阅 axisY 。

barWidth : real

宽度单位是 x 轴的单位。条形图的最小宽度为零，负值视为零。将宽度设置为零意味着无论 x 轴的比例如何，屏幕上条形图的宽度都是一个像素。宽度大于零的条形图将使用 x 轴的比例进行缩放。

count : int [read-only]

条形图系列中的条形图组数。

labelsAngle : real

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

labelsFormat : string

条形数列中用于显示标签的格式。

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

labelsPosition : enumeration

数据值标签的位置：

另请参阅 labelsVisible 和labelsFormat 。

labelsPrecision : real

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

默认值为 6。

labelsVisible : bool

条形序列中标签的可见度。

信号文档

barsetsAdded()

该信号在条形集添加到系列时发出。

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

barsetsRemoved()

从系列中移除条形集时发出该信号。

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

clicked(int index, BarSet barset)

当用户在barset 指定的条形图集中点击index 指定的条形图时，就会发出该信号。

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

doubleClicked(int index, BarSet barset)

当用户在barset 指定的条形图集中双击index 指定的条形图时，会发出该信号。

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

hovered(bool status, int index, BarSet barset)

当鼠标悬停在barset 指定的条形图集中index 指定的条形图上时，就会发出该信号。当鼠标移到条形图上时，status 会变成true ，当鼠标再次移开时，会变成false 。

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

pressed(int index, BarSet barset)

当用户在barset 指定的条形图集中点击index 指定的条形图并按住鼠标键时，就会发出该信号。

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

released(int index, BarSet barset)

当用户在barset 所指定的条形图集合中index 所指定的条形图上松开鼠标时，就会发出该信号。

相应的信号处理程序是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)

返回设置在index 的条形图。如果索引无效，则返回空值。

void clear()

删除系列中的所有条形码组。

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

将label 和values 添加到index 。values 可以是实数值列表，也可以是XYPoint 类型列表。

如果索引值等于或小于零，新条形集将被添加到条形系列中。如果索引值等于或大于条形图系列中条形图集的数量，则新条形图集将附加到条形图系列中。

另请参阅 append().

bool remove(BarSet barset)

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