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 轴的比例如何，屏幕上柱状图的宽度均为 1 像素。宽度大于零的柱状图将根据 x 轴的比例进行缩放。

count : int [read-only]

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

labelsAngle : real

值标签的角度（单位：度）。

labelsFormat : string

用于在条形图系列中显示标签的格式。

另请参阅 QAbstractBarSeries::labelsFormat 、labelsVisible 以及labelsPosition 。

labelsPosition : enumeration

数据值标签的位置：

另请参阅 labelsVisible 和labelsFormat 。

labelsPrecision : real

值标签中显示的有效数字位数上限。

默认值为 6。

labelsVisible : bool

条形系列中标签的可见性。

Signal 文档

barsetsAdded()

当向系列中添加柱状图数据集时，会触发此信号。

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

barsetsRemoved()

当从系列中移除柱形组时，会触发此信号。

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

clicked(int index, BarSet barset)

当用户点击由 `index ` 指定的、位于由 `barset` 指定的条形集合中的条形时，将触发此信号。

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

doubleClicked(int index, BarSet barset)

当用户双击由 `index ` 指定的条形（该条形位于由 `barset` 指定的条形集内）时，会触发此信号。

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

hovered(bool status, int index, BarSet barset)

当鼠标悬停在由 `index ` 指定的、位于 `barset` 指定的柱状图集中的柱状图上时，会触发此信号。当鼠标移过该柱状图时，`status ` 会变为 `true`；当鼠标再次移开时，它会变为 `false`。

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

pressed(int index, BarSet barset)

当用户点击由index 指定的、位于由barset 指定的条形集合中的条形，并按住鼠标按钮时，会触发此信号。

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

released(int index, BarSet barset)

当用户松开鼠标，且鼠标指针位于由index 指定的、属于barset 所指定的条形图集中的某个条形上时，将触发此信号。

相应的信号处理程序为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 处设置的条形。如果索引无效，则返回null。

void clear()

从该组中移除所有杠铃组。

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

向index 添加一个包含label 和values 的新柱状图集。values 可以是实数值列表，也可以是 XYPoint 类型的列表。

如果索引值小于等于零，则将新柱形图集插入到柱形图序列的开头；如果索引值大于等于柱形图序列中的柱形图集数量，则将新柱形图集追加到柱形图序列的末尾。

另请参阅 append()。

bool remove(BarSet barset)

从系列中移除由barset 指定的柱状图集合。若操作成功，返回true ；否则返回false 。