class QAbstractBarSeries#

QAbstractBarSeries 类是所有柱状图类的一个抽象基类。 更多…

Inheritance diagram of PySide6.QtGraphs.QAbstractBarSeries

继承自: QBarSeriesQStackedBarSeriesQPercentBarSeriesQHorizontalStackedBarSeriesQHorizontalPercentBarSeriesQHorizontalBarSeries

概要#

属性#

方法#

信号#

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译存在问题,您也可以通过在https:/bugreports.qt.io/projects/PYSIDE创建票据的方式告知我们

详细描述#

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

如果对于主要柱轴使用的是QValueAxis而不是QBarCategoryAxis,则柱子将围绕类别的索引值分组。

查看带有小部件的图表画廊了解如何使用QBarSeries类创建简单的柱状图。

class LabelsPosition#

枚举值描述了数据值标签的位置

常量

描述

QAbstractBarSeries.LabelsCenter

标签位于柱状图的中心。

QAbstractBarSeries.LabelsInsideEnd

标签位于柱状图的顶部内部。

QAbstractBarSeries.LabelsInsideBase

标签位于柱状图的底部内部。

QAbstractBarSeries.LabelsOutsideEnd

标签位于柱状图的顶部外部。

注意

当使用from __feature__ import true_property时,可以直接使用属性,否则请通过访问函数。

属性 barWidth: float#

此属性保存系列柱状图的宽度。

宽度的单位是x轴的单位。柱状图的最小宽度为零,负值视为零。将宽度设置为零意味着在任何比例的x轴下,屏幕上柱状的宽度为1个像素。大于零的柱状图宽度使用x轴比例进行缩放。

注意

当与QBarSeries一起使用时,此值指定了一组柱状图的宽度,而不是单个柱状图的宽度。

另请参阅

QBarSeries

访问函数
属性 count: int#

此属性保存柱状系列中的柱状图集数量。

访问函数
属性 labelsAngle: float#

此属性保存值标签的角度(以度为单位)。

访问函数
属性 labelsFormat: str#

此属性用于控制显示条形系列中标签的格式。

QAbstractBarSeries 支持以下格式标记

@value

条形的值

例如,以下格式标记的使用会产生显示值和单位的标签(u)

series->setLabelsFormat("@value u");

默认情况下,标签显示条形的值。对于百分比条形系列,值后会添加“%”。标签显示在绘图区域,如果条形靠得很近,标签可能会重叠。

另请参阅

labelsVisible labelsPosition labelsPrecision

访问函数
属性 labelsPosition: QAbstractBarSeries.LabelsPosition#

此属性控制标签的位置。

另请参阅

labelsVisible labelsFormat

访问函数

属性 labelsPrecision: int#

此属性控制值标签中显示的最大有效数字数量。

默认值为 6。

访问函数
属性 labelsVisible: bool#

此属性控制条形系列中标签的可见性。

访问函数
barWidth()#
返回类型:

float

获取系列中柱状图的宽度。

另请参阅

setBarWidth()

属性 barWidthᅟ 的获取器。

clear()#

从系列中移除所有柱状图集,并将其永久删除。

count()#
返回类型:

int

返回柱状系列中的柱状图集数量。

属性 countᅟ 的获取器。

countChanged()#

当柱状图集的数量发生变化时(例如使用 append()remove()),会发出此信号。

属性 countᅟ 的通知信号。

isLabelsVisible()#
返回类型:

bool

返回标签的可见性。

属性 labelsVisibleᅟ 的获取器。

labelsAngle()#
返回类型:

float

另请参阅

setLabelsAngle()

属性 labelsAngleᅟ 的获取器。

labelsAngleChanged(angle)#
参数:

angle – float

当值标签的 angle 发生变化时,会发出此信号。

属性 labelsAngleᅟ 的通知信号。

labelsFormat()#
返回类型:

str

另请参阅

setLabelsFormat()

属性 labelsFormatᅟ 的获取器。

labelsFormatChanged(format)#
参数:

format – str

当数据值标签的 format 发生变化时,会发出此信号。

属性 labelsFormatᅟ 的通知信号。

labelsPrecision()#
返回类型:

int

另请参阅

setLabelsPrecision()

属性 labelsPrecision 的获取器。

labelsPrecisionChanged(precision)#
参数:

precision – int

当值标签的精度发生变化时,发出此信号。

labelsPrecision 属性的通知信号。

labelsVisibleChanged()#

当标签的可见性发生变化时,发出此信号。

labelsVisible 属性的通知信号。

setBarWidth(width)#
参数:

width – float

将系列条形的宽度设置为 width

另请参阅

barWidth()

barWidth 属性的设置器。

setLabelsAngle(angle)#
参数:

angle – float

另请参阅

labelsAngle()

labelsAngle 属性的设置器。

setLabelsFormat(format)#
参数:

format – str

另请参阅

labelsFormat()

labelsFormat 属性的设置器。

setLabelsPrecision(precision)#
参数:

precision – int

另请参阅

labelsPrecision()

labelsPrecision 属性的设置器。

setLabelsVisible([visible=true])#
参数:

visible – bool

设置条形系列中标签的可见性为 可见

另请参阅

isLabelsVisible()

属性 labelsVisible 的设置器。