class QPieSlice#

QPieSlice类表示饼图序列中的单一切片。 更多信息…

Inheritance diagram of PySide6.QtCharts.QPieSlice

摘要#

属性#

方法#

信号#

注意

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

详细描述#

饼图切片有一个值和一个标签。当切片添加到饼图系列中时，QPieSeries 对象会计算切片与系列中所有切片总和的百分比，以确定饼图中切片的实际大小。

默认情况下，标签是隐藏的。如果它可见，它可以是位于切片外并通过臂连接到它，或者水平于切片的中心，或平行于切片圆形弧的切线或法线。

默认情况下，切片的视觉外观由主题设置，但可以通过指定切片属性来覆盖主题。但是，如果在切片定制后更改主题，所有定制将丢失。

为了启用用户与饼图的交互，当用户点击饼图切片或将其鼠标悬停在其上时，会发出一些基本信号。

另请参阅

QPieSeries

类 LabelPosition#

此枚举描述了切片标签的位置。

常量

描述

QPieSlice.LabelOutside

标签位于切片外部，并通过臂与其连接。这是默认值。

QPieSlice.LabelInsideHorizontal

标签位于切片内并水平排列。

QPieSlice.LabelInsideTangential

标签位于切片内，旋转到与切片圆形弧的切线平行。

QPieSlice.LabelInsideNormal

标签位于切片内，旋转到与切片圆形弧的法线平行。

注意

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

属性 angleSpan: float#

此属性表示切片的角度范围。整个饼图是360度，其中0度在12点位置。一旦将切片添加到系列中，将自动更新。

访问函数
属性 borderColor: QColor#

此属性表示绘制切片边框所使用的颜色。这是一个用于修改切片画笔的便利属性。

另请参阅

pen borderWidth

访问函数
属性 borderWidth: int#

此属性表示切片边框的宽度。这是一个用于修改切片画笔的便利属性。

另请参阅

pen borderColor

访问函数
属性 brush: QBrush#

此属性表示用于填充切片的画刷。

访问函数
属性 color: QColor#

此属性表示切片填充（画刷）颜色。这是一个用于修改切片画刷的便利属性。

另请参阅

brush

访问函数
属性 explodeDistanceFactor: float#

此属性表示切片相对于饼图爆炸距离。

  • 1.0 表示距离等于半径。

  • 0.5 表示距离是半径的一半。

默认情况下，距离为 0.15

另请参阅

已分解

访问函数
属性 exploded: 布尔值#

此属性表示切片是否从饼图中分离出来。

另请参阅

explodeDistanceFactor

访问函数
属性 label: 字符串#

此属性保留切片的标签。

注意

字符串可以是 HTML 格式。

另请参阅

labelVisible labelBrush labelFont labelArmLengthFactor

访问函数
属性 labelArmLengthFactor: 浮点数#

此属性保留标签臂的长度。该系数相对于饼图的半径。例如：

  • 1.0 表示长度与半径相同。

  • 0.5 表示长度是半径的一半。

默认情况下，臂长度为 0.15

另请参阅

label labelVisible labelBrush labelFont

访问函数
属性 labelBrush: QBrush#

此属性保留用于绘制切片标签和标签臂的画笔。

另请参阅

label labelVisible labelFont labelArmLengthFactor

访问函数
属性 labelColor: QColor#

此属性保存用于绘制切片标签的颜色。这是一个用于修改切片标签画笔的便利属性。

另请参阅

labelBrush

访问函数
属性 labelFont: QFont#

此属性保存用于绘制标签文本的字体。

另请参阅

label labelVisible labelArmLengthFactor

访问函数
属性 labelPosition: QPieSlice.LabelPosition#

此属性保存切片标签的位置。

另请参阅

label labelVisible

访问函数
属性 labelVisible: bool#

此属性保存切片标签的可见性。默认情况下，标签不可见。

访问函数
属性 pen: QPen#

此属性保存用于绘制切片边框的画笔。

访问函数
属性percentage: float#

此属性保存了与系列中所有切片总和相比的切片百分比。实际值范围从0.0到1.0。一旦切片添加到系列中，将自动更新。

另请参阅

value sum

访问函数
属性startAngle: float#

此属性保存了此切片在其所属系列中的起始角度。完整的饼图为360度，其中0度位于12点位置。一旦切片添加到系列中，将自动更新。

访问函数
属性value: float#

此属性保存了切片的值。

注意

负值将被转换为正值。

另请参阅

percentage() sum()

访问函数
__init__(label, value[, parent=None])#
参数:

  • label – str

  • value – float

  • parent – QObject

构造一个带有指定 value、label 和 parent 的空切片。

另请参阅

append() insert()

__init__([parent=None])
参数:

parent – QObject

使用父对象 parent 构建一个空的片段。

另请参阅

append() insert()

angleSpan()#
返回类型：

float

属性 angleSpan 的获取方法。

angleSpanChanged()#

当片断的角度跨度变化时，会发出此信号。

另请参阅

angleSpan

属性 angleSpan 的通知信号。

borderColor()#
返回类型：

QColor

另请参阅

setBorderColor()

属性 borderColor 的获取方法。

borderColorChanged()#

当片断的边框颜色变化时，会发出此信号。

另请参阅

pen borderColor

属性 borderColor 的通知信号。

borderWidth()#
返回类型：

int

另请参阅

setBorderWidth()

属性 borderWidth 的获取方法。

borderWidthChanged()#

当片断边框宽度变化时，会发出此信号。

另请参阅

pen borderWidth

属性 borderWidth 的通知信号。

brush()#
返回类型：

QBrush

另请参阅

setBrush()

属性 brush 的获取方法。

brushChanged()#

当用于填充片断的画笔变化时，会发出此信号。

另请参阅

brush

属性 brush 的通知信号。

clicked()#

当点击片断时，会发出此信号。

另请参阅

clicked()

color()#
返回类型：

QColor

另请参阅

setColor()

属性 color 的获取方法。

colorChanged()#

当切片颜色改变时发出此信号。

另请参阅

brush

属性 color 的通知信号。

doubleClicked()#

当用户双击切片时发出此信号。

另请参阅

doubleClicked()

explodeDistanceFactor()#
返回类型：

float

另请参阅

setExplodeDistanceFactor()

属性 explodeDistanceFactor 的获取器。

hovered(state)#
参数:

state – bool

当鼠标悬停在切片上时发出此信号。当鼠标移至切片上时，state 变为 true，当鼠标再次移开时，变为 false。

另请参阅

hovered()

isExploded()#
返回类型：

bool

属性 exploded 的获取器。

isLabelVisible()#
返回类型：

bool

属性 labelVisible 的获取器。

label()#
返回类型：

str

另请参阅

setLabel()

属性 label 的获取器。

labelArmLengthFactor()#
返回类型：

float

另请参阅

setLabelArmLengthFactor()

属性 labelArmLengthFactor 的获取器。

labelBrush()#
返回类型：

QBrush

另请参阅

setLabelBrush()

属性 labelBrush 的获取器。

labelBrushChanged()#

当切片标签画笔变更时发出此信号。

另请参阅

labelBrush

属性 labelBrush 的通知信号。

labelChanged()#

当切片标签变更时发出此信号。

另请参阅

label

属性 label 的通知信号。

labelColor()#
返回类型：

QColor

另请参阅

setLabelColor()

属性 labelColor 的获取器。

labelColorChanged()#

当切片标签颜色改变时，会发出此信号。

另请参阅

labelColor

属性 labelColor 的通知信号。

labelFont()#
返回类型：

QFont

另请参阅

setLabelFont()

属性 labelFont 的获取器。

labelFontChanged()#

当切片标签的字体改变时，会发出此信号。

另请参阅

labelFont

属性 labelFont 的通知信号。

labelPosition()#
返回类型：

LabelPosition

另请参阅

setLabelPosition()

属性 labelPosition 的获取器。

labelVisibleChanged()#

当切片标签的可见性改变时，会发出此信号。

另请参阅

labelVisible

属性 labelVisible 的通知信号。

pen()#
返回类型：

QPen

另请参阅

setPen()

属性 pen 的获取器。

penChanged()#

当用于绘制切片边框的画笔改变时，会发出此信号。

另请参阅

pen

属性 pen 的通知信号。

percentage()#
返回类型：

float

属性 percentage 的获取器。

percentageChanged()#

当切片的百分比变化时发出此信号。

另请参阅

percentage

属性 percentage 的通知信号。

pressed()#

当用户点击切片并按下鼠标按钮时发出此信号。

另请参阅

pressed()

released()#

当用户释放切片上的鼠标按下时发出此信号。

另请参阅

released()

series()#
返回类型：

QPieSeries

返回此切片所属的序列。

另请参阅

append()

setBorderColor(color)#
参数:

color – QColor

另请参阅

borderColor()

borderColor 属性的设置器。

setBorderWidth(width)#
参数:

width – int

另请参阅

borderWidth()

borderWidth 属性的设置器。

setBrush(brush)#
参数:

brush – QBrush

另请参阅

brush()

brush 属性的设置器。

setColor(color)#
参数:

color – QColor

另请参阅

color()

color 属性的设置器。

setExplodeDistanceFactor(factor)#
参数:

factor – float

另请参阅

explodeDistanceFactor()

explodeDistanceFactor 属性的设置器。

setExploded([exploded=True])#
参数:

exploded – bool

另请参阅

isExploded()

属性 exploded 的设置器。

setLabel(label)#
参数:

label – str

另请参阅

label()

属性 label 的设置器。

setLabelArmLengthFactor(factor)#
参数:

factor – float

另请参阅

labelArmLengthFactor()

属性 labelArmLengthFactor 的设置器。

setLabelBrush(brush)#
参数:

brush – QBrush

另请参阅

labelBrush()

属性 labelBrush 的设置器。

setLabelColor(color)#
参数:

color – QColor

另请参阅

labelColor()

属性 labelColor 的设置器。

setLabelFont(font)#
参数:

font – QFont

另请参阅

labelFont()

属性 labelFont 的设置器。

setLabelPosition(position)#
参数:

position – LabelPosition

另请参阅

labelPosition()

属性 labelPosition 的设置器。

setLabelVisible([visible=True])#
参数:

visible – bool

另请参阅

isLabelVisible()

属性 labelVisible 的设置器。

setPen(pen)#
参数:

画笔 – QPen

另请参阅

pen()

属性 pen 的设置器。

setValue(value)#
参数:

value – float

另请参阅

value()

属性 value 的设置器。

startAngle()#
返回类型：

float

属性 startAngle 的获取器。

startAngleChanged()#

当切片的起始角度发生变化时，会发出此信号。

另请参阅

startAngle

属性 startAngle 的通知信号。

value()#
返回类型：

float

另请参阅

setValue()

属性 value 的获取器。

valueChanged()#

当切片值发生变化时，会发出此信号。

另请参阅

value

属性 value 的通知信号。