class QAbstractBarSeries

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

继承自： QBarSeries，QStackedBarSeries，QPercentBarSeries，QHorizontalStackedBarSeries，QHorizontalPercentBarSeries，QHorizontalBarSeries

概要

属性

• barWidthᅟ - 系列条形的宽度

• countᅟ - 条形系列中的条形组数量

• labelsAngleᅟ - 价值标签的角度（以度为单位）

• labelsFormatᅟ - 在条形系列中显示标签所使用的格式

• labelsPositionᅟ - 价值标签的位置

• labelsPrecisionᅟ - 价值标签中显示的最大有效数字数量

• labelsVisibleᅟ - 条形系列中标签的可见性

方法

• def barWidth()

• def clear()

• def count()

• def isLabelsVisible()

• def labelsAngle()

• def labelsFormat()

• def labelsPrecision()

• 定义 setBarWidth()

• 定义 setLabelsAngle()

• 定义 setLabelsFormat()

• 定义 setLabelsPrecision()

• 定义 setLabelsVisible()

信号

• 定义 countChanged()

• 定义 labelsAngleChanged()

• 定义 labelsFormatChanged()

• 定义 labelsPrecisionChanged()

• 定义 labelsVisibleChanged()

注意

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

详细描述

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

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

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

另请参阅

QBarSet QBarSeries QStackedBarSeries QPercentBarSeries QHorizontalBarSeries QHorizontalStackedBarSeries QHorizontalPercentBarSeries

class LabelsPosition

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

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

注意

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

属性 barWidth: float

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

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

注意

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

另请参阅

QBarSeries

访问函数

• barWidth()

• setBarWidth()

属性 count: int

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

访问函数

• count()

• 信号 countChanged

属性 labelsAngle: float

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

访问函数

• labelsAngle()

• setLabelsAngle()

• 信号 labelsAngleChanged()

属性 labelsFormat: str

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

QAbstractBarSeries 支持以下格式标记

@value

条形的值

例如，以下格式标记的使用会产生显示值和单位的标签（u）

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

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

另请参阅

labelsVisible labelsPosition labelsPrecision

访问函数

• labelsFormat()

• setLabelsFormat()

• 信号 labelsFormatChanged()

属性 labelsPosition: QAbstractBarSeries.LabelsPosition

此属性控制标签的位置。

另请参阅

labelsVisible labelsFormat

访问函数

属性 labelsPrecision: int

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

默认值为 6。

访问函数

• labelsPrecision()

• setLabelsPrecision()

• 信号 labelsPrecisionChanged()

属性 labelsVisible: bool

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

访问函数

• isLabelsVisible()

• setLabelsVisible()

• 信号 labelsVisibleChanged()

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()

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

另请参阅

isLabelsVisible() setLabelsVisible()

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 的设置器。