class QPieSeries

QPieSeries类以扇形图的形式展示数据。关于更多信息，请参阅更多...

概述

属性

• count - 系列中的切片数

• endAngle - 派对的结束角度

• holeSize - 环形蛋糕洞大小

• horizontalPosition - 饼图的水平位置

• size - 饼图大小

• startAngle - 饼图的起始角度

• sum - 所有切片的总和

• verticalPosition - 饼图的垂直位置

方法

• def __init__()

• def append()

• def clear()

• def count()

• def holeSize()

• def horizontalPosition()

• def insert()

• def isEmpty()

• def __lshift__()

• def pieEndAngle()

• def pieSize()

• def pieStartAngle()

• def remove()

• def setHoleSize()

• def setHorizontalPosition()

• def setLabelsPosition()

• def setLabelsVisible()

• def setPieEndAngle()

• def setPieSize()

• 定义 setPieStartAngle()

• 定义 setVerticalPosition()

• 定义 slices()

• 定义 sum()

• 定义 take()

• 定义 verticalPosition()

信号

• 定义 added()

• 定义 clicked()

• 定义 countChanged()

• 定义 doubleClicked()

• 定义 hovered()

• 定义 pressed()

• 定义 released()

• 定义 removed()

• 定义 sumChanged()

注意

此文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎为代码片段翻译做出贡献。如果您发现翻译存在问题，也可以在https:/bugreports.qt.io/projects/PYSIDE上创建一个工单让我们知道。

详细描述

饼图系列由作为 QPieSlice 对象定义的切片组成。切片可以具有任意值，而饼图系列对象通过计算切片与系列中所有切片总和的百分比来确定切片在图表中的实际大小。

饼图大小和位于图表上的位置通过使用从0.0到1.0的相对值来控制。这些值与实际的图表矩形相关。

默认情况下，饼图被定义为完整的饼图。通过为系列设置起始角度和角度跨度可以创建部分饼图。完整的饼图是360度，其中12点位置为0度。

请参阅带有小部件的图表库来了解如何使用QPieSeries。

另请参阅

QPieSlice QChart

注意

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

propertycount: int

此属性包含系列中切片的数量。

访问函数

• count()

• 信号 countChanged()

propertyendAngle: float

此属性包含饼图的结束角度。

完整饼图为360度，其中12点钟方向为0度。

默认值为360。

访问函数

• pieEndAngle()

• setPieEndAngle()

propertyholeSize: float

此属性包含甜甜圈的洞大小。

此值相对于图表矩形，因此

• 0.0是最小尺寸（完整饼图绘制时无洞）。

• 1.0是可以适应图表的最大尺寸（甜甜圈没有宽度）。

在设置此属性时，如果需要，调整size属性，以确保洞大小不超过饼图大小。

默认值为0.0。

访问函数

• holeSize()

• setHoleSize()

propertyhorizontalPosition: float

此属性包含饼图的水平位置。

此值相对于图表矩形，因此

• 0.0是完全左侧。

• 1.0是完全右侧。

默认值为0.5（居中）。

另请参阅

verticalPosition

访问函数

• horizontalPosition()

• setHorizontalPosition()

propertysize: float

此属性包含饼图的大小。

此值相对于图表矩形，因此

• 0.0是最小尺寸（饼图不绘制）。

• 1.0是可以适应图表的最大尺寸。

在设置此属性时，如果需要，调整holeSize属性，以确保洞大小不超过饼图大小。

默认值为0.7。

访问函数

• pieSize()

• setPieSize()

属性 startAngle: float

此属性保存饼图的起始角度。

完整饼图为360度，其中12点钟方向为0度。

默认值为0。

访问函数

• pieStartAngle()

• setPieStartAngle()

属性 sum: float

此属性保存所有切片的总和。

序列会跟踪所包含所有切片的总和。

访问函数

• sum()

• 信号 sumChanged()

属性 verticalPosition: float

此属性保存饼图的垂直位置。

此值相对于图表矩形，因此

• 0.0表示绝对顶部。

• 1.0表示绝对底部。

默认值为0.5（居中）。

另请参阅

horizontalPosition

访问函数

• verticalPosition()

• setVerticalPosition()

__init__([parent=None])

参数:

parent – QObject

构建系列的成员对象，它是parent的子元素。

added(slices)

参数:

slices – .饼图切片列表

当指定由slices包含的切片被添加到序列时，将发出此信号。

另请参阅

append() insert()

append(slices)

参数:

slices – .饼图切片列表

返回类型:

bool

将由slices指定的切片数组追加到序列中。切片的所有权传递给序列。

如果追加成功，则返回true。

append(label, value)

参数:

• label – str

• value – float

返回类型:

QPieSlice

将具有指定value和label的单个切片追加到序列中。切片的所有权传递给序列。如果value是NaN、Inf或-Inf，则返回null，且不会向序列中添加任何内容。

append(slice)

参数:

slice – QPieSlice

返回类型:

bool

将指定的 slice 添加到系列中。切片的所有权传递到系列中。

如果追加成功，则返回true。

clear()

清除系列中的所有切片。

clicked(slice)

参数:

slice – QPieSlice

当指定切片被点击时，会发出此信号。

另请参阅

clicked()

count()

返回类型:

int

返回该系列中切片的数量。

属性 count 的获取器。

countChanged()

切片计数改变时发出此信号。

另请参阅

count

属性 count 的通知信号。

doubleClicked(slice)

参数:

slice – QPieSlice

当指定切片被双击时，会发出此信号。

另请参阅

doubleClicked()

holeSize()

返回类型:

float

另请参阅

setHoleSize()

属性 holeSize 的获取器。

horizontalPosition()

返回类型:

float

另请参阅

setHorizontalPosition()

属性 horizontalPosition 的获取器。

hovered(slice, state)

参数:

• slice – QPieSlice

• state – bool

当鼠标悬停在指定切片 slice 上时发出此信号。当鼠标移入切片时，state 变为 true，而当鼠标再次移出时，它变为 false。

另请参阅

hovered()

insert(index, slice)

参数:

• index – int

• slice – QPieSlice

返回类型:

bool

将指定切片插入到由index指定的位置之前的系列中。切片所有权传递给系列。

如果插入成功，则返回true。

isEmpty()

返回类型:

bool

如果系列为空，则返回true。

__lshift__(slice)

参数:

slice – QPieSlice

返回类型:

QPieSeries

将指定切片 slice 添加到系列中，并返回对系列的引用。切片所有权传递给系列。

pieEndAngle()

返回类型:

float

返回饼图的结束角度。

完整饼图为360度，其中12点钟方向为0度。

另请参阅

setPieEndAngle() pieStartAngle() setPieStartAngle()

属性endAngle的获取器。

pieSize()

返回类型:

float

另请参阅

setPieSize()

属性size的获取器。

pieStartAngle()

返回类型:

float

另请参阅

setPieStartAngle()

属性startAngle的获取器。

pressed(slice)

参数:

slice – QPieSlice

当用户点击由slice指定的切片并按下鼠标按钮时，会发出此信号。

另请参阅

pressed()

released(slice)

参数:

slice – QPieSlice

当用户在由slice指定的切片上释放鼠标按钮时，会发出此信号。

另请参阅

released()

remove(slice)

参数:

slice – QPieSlice

返回类型:

bool

从系列中删除单个切片（由 slice 指定），并永久删除它。

此调用后无法再引用指针。

如果删除成功，则返回true。

remove(slices)

参数:

slices – .饼图切片列表

当指定为slices的扇区从系列中删除时，会发出此信号。

另请参阅

remove()

setHoleSize(holeSize)

参数:

holeSize – float

另请参阅

holeSize()

是属性holeSize的设置器。

setHorizontalPosition(relativePosition)

参数:

relativePosition – float

另请参阅

horizontalPosition()

是属性horizontalPosition的设置器。

setLabelsPosition(position)

参数:

position – LabelPosition

将所有切片标签的位置设置为position。

注意

此函数仅影响系列中的当前切片。如果添加新切片，则默认标签位置为LabelOutside。

另请参阅

labelPosition() setLabelPosition()

setLabelsVisible([visible=true])

参数:

visible – bool

设置所有切片标签的可见性为visible。

注意

此函数仅影响系列中的当前切片。如果添加新的切片，则默认标签可见性为false。

另请参阅

isLabelVisible() setLabelVisible()

setPieEndAngle(endAngle)

参数:

endAngle – float

设置饼图的结束角度。

完整饼图为360度，其中12点钟方向为0度。

角度必须大于起始角度。

另请参阅

pieEndAngle() pieStartAngle() setPieStartAngle()

属性 endAngle 的设置器。

setPieSize(relativeSize)

参数:

relativeSize —— 浮点数

另请参阅

pieSize()

属性 size 的设置器。

setPieStartAngle(startAngle)

参数:

startAngle —— 浮点数

另请参阅

pieStartAngle()

属性 startAngle 的设置器。

setVerticalPosition(relativePosition)

参数:

relativePosition – float

另请参阅

verticalPosition()

属性 verticalPosition 的设置器。

slices()

返回类型:

列表 of QPieSlice

返回属于此系列的切片列表。

sum()

返回类型:

float

返回此系列中所有切片值的总和。

另请参阅

value() setValue() percentage()

属性 sum 的获取器。

sumChanged()

当所有切片的总和改变时发出此信号。

另请参阅

sum

属性 sum 的通知信号。

take(slice)

参数:

slice – QPieSlice

返回类型:

bool

从系列中获取单个切片（由 slice 指定）。不删除切片对象。

注意

系列仍然是要删除切片的父对象。您必须设置父对象以完全拥有。

如果取操作成功，则返回 true。

verticalPosition()

返回类型:

float

另请参阅

setVerticalPosition()

属性 verticalPosition 回顾 的获取器。