QML 抽象柱状系列类型

所有柱状系列类型的抽象基类。 更多信息...

导入语句import QtCharts 2.7
实例化 QAbstractBarSeries
继承自

AbstractSeries

派生于

BarSeries、HorizontalBarSeries、HorizontalPercentBarSeries、HorizontalStackedBarSeries、PercentBarSeries和StackedBarSeries

属性

信号

方法

  • BarSet append(string label, VariantList values)
  • BarSet at(int index)
  • 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

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

注意： 您只能提供axisX或axisXTop中的任意一个，但不能同时提供。

另请参阅 axisX.


axisY : AbstractAxis

用于系列的Y轴。如果您同时未定义axisY和axisYRight，将为系列创建一个ValueAxis。

另请参阅 axisYRight.


axisYRight : AbstractAxis

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

注意： 您只能提供axisY或axisYRight中的任意一个，但不能同时提供。

另请参阅 axisY.


barWidth : real

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

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


count : int [只读]

柱状系列中柱集的数量。


labelsAngle : real

数值标签的角度（以度为单位）。


labelsFormat : string

在柱状系列中显示标签时使用的格式。

参见 QAbstractBarSeries::labelsFormat、labelsVisible 和 labelsPosition。


labelsPosition : 枚举

数据值标签的位置

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

参见 labelsVisible 和 labelsFormat。


labelsPrecision : 实数

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

默认值为6。


labelsVisible : 布尔值

柱状系列中标签的可见性。


信号文档

barsetsAdded()

当将柱状集添加到系列中时，会发出此信号。

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

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


barsetsRemoved()

当从系列中移除柱状集时，会发出此信号。

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

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


clicked(int index, 柱状集 barset)

当用户点击由 index 指定的柱状集内的柱状图时，会发出此信号。

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

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


doubleClicked(int index, 柱状集 barset)

当用户双击由 index 指定的柱状集内的柱状图时，会发出此信号。

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

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


hovered(布尔值 status, int index, 柱状集 barset)

当鼠标悬停在由 index 指定的柱状集内的指定柱状图上时，会发出此信号。当鼠标移动到柱状图上时，status 变为 true，当鼠标重新移动开时，它变为 false。

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

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


pressed(int index, 柱状集 barset)

当用户点击由 index 指定的柱状集内的柱状图并按住鼠标按钮时，会发出此信号。

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

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


released(int index, 柱状集 barset)

当用户在由 index 指定的柱状集内的柱状图上释放鼠标按钮时，会发出此信号。

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

向 index 添加一个新的条形图集，具有 label 和 values。 values 可以是实数值列表或者是 XYPoint 类型列表。

如果索引值等于或小于零，新条形图集将添加到条形系列的开头。如果索引值等于或大于条形系列中的条形图集数，新条形图集将添加到条形系列的末尾。

另见 append().


bool remove(BarSet barset)

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


© 2024 The Qt Company Ltd. 本文档中的贡献版权属于各自的所有者。本提供的文档根据自由软件基金会的发布，受GNU自由文档许可证版本1.3的条款许可。Qt及其相应标志是The Qt Company Ltd.在芬兰以及/或世界其他国家的商标。所有其他商标均为各自所有者的财产。