饼图是数据可视图表的基本类型，在QChart中，QPieSeries, QPieSlice处理饼图的绘制。

QPieSeries

QPieSeries类以饼图形式显示数据。饼图系列由定义为QPieSlice对象的切片组成。切片可以具有任何值，因为QPieSeries对象计算切片的百分比与系列中所有切片的总和之比，以确定图表中切片的实际大小。饼图的大小和在图表上的位置是通过使用0.0到1.0范围内的相对值来控制的,这些与实际的图表矩形有关。默认情况下，该饼被定义为完整饼。通过设置系列的起始角度和角度跨度可以创建局部饼图。完整的饼图是360度，其中12点是0。

QPieSeries常用函数：

• append(self, slice): 添加一个切片slice到饼图中
• append(label, value): 将指定label和value的切片添加到饼图中，如果添加成功则返回切片对象，否则返回空值。
• clear(self): 清除饼图中的所有切片。
• count(self): 获得切片数目
• setHoleSize(self):设置饼图孔洞尺寸，该值相对于图表矩形。0.0是最小大小(绘制完整的饼图，不带孔)。1.0是可以容纳图表的最大尺寸(甜甜圈没有宽度)。默认值为0.0。设置此属性时，如有必要，将调整size属性，以确保孔大小不大于饼图大小。
• setLabelsVisible(self, visible): 将所有切片标签的可见性设置为visible。注意：此功能仅影响序列中的当前切片。如果添加了新切片，则默认标签可见性为False。
• setPieStartAngle(self, startAngle): 设置饼图的开始角度为startAngle，完整的饼图是360度，其中12点是0度。默认值为360。
• setPieEndAngle(self, endAngle): 设置饼图结束角度为endAngle。
• setPieSize(self, relativeSize): 设置饼图的相对尺寸为relativeSize，该值相对于图表矩形, 0.0是最小尺寸(未绘制饼图)，1.0是适合图表的最大尺寸。默认值为0.7。设置此属性时，如有必要，将调整holeSize属性，以确保孔大小不大于饼图大小。
• sum(self): 返回饼图中所有切片值的总和。
• reomove(self, slice): 从饼图中删除指定的切片slice。切片将被永久删除。
• take(self, slice): 从饼图中获取由slice指定的单个切片。不删除切片对象。

QPieSeries常用信号：

• added(self, slices): 当slices加入到饼图时信号被发射。
• clicked(self,slice): 单击由slice指定的切片时，发射该信号。
• countChanged(self): 当切片计数改变时，该信号被发射。
• doubleClicked(slef, slice): 双击由slice指定的切片时，将发出此信号。
• hovered(self, slice, state): 当鼠标悬停在slice指定的切片上时，将发出此信号。当鼠标移到切片上时，state变为True，而当鼠标再次移开时，state变为False。
• pressed(self, slice): 当用户单击由slice指定的切片并按住鼠标按钮时，将发出此信号。
• released(self, slice): 当用户释放对slice指定的切片的鼠标按下时，将发出此信号。
• removed(self,slices): 当从饼图中删除由片段指定的slices时，将发出此信号。
• sumChanged():当所有切片的总和发生变化时，将发射该信号。

QPieSlice

QPieSlice类表示一个饼图系列中的单个切片。饼图切片具有一个值和一个标签。将切片添加到饼图时，QPieSeries对象将计算该切片与该系列中所有切片的总和相比较的百分比，以确定图表中切片的实际大小。默认情况下，标签是隐藏的。如果可见，则可以将其放置在切片的外部，并用手臂将其连接，也可以将其水平或平行于切片弧的切线或法线居中放置在切片内部。默认情况下，切片的视觉外观是由主题设置的，但是可以通过指定切片属性来覆盖主题。为了使用户能够与饼图进行交互，当用户单击饼图或将鼠标悬停在饼图上时，会发出一些基本信号。

QPieSlice常用函数：

• setBorderColor(self,color): 设置用于绘制切片边界的颜色。
• setBorderWidth(self, width)：设置切片边界的宽度。
• setBrush(self, brush)：设置用于填充切片的画刷。
• setColor(self, color): 设置切片的填充(画刷)颜色。
• setExplodeDistanceFactor(self, factor): 设置explode切片偏移饼的距离。1.0表示距离与半径相同。0.5表示该距离是半径的一半。默认距离为0.15。
• setExploded(self, exploded): 设置切片的explode属性。
• setLabel(self, label): 设置切片的标签。
• setLabelArmLengthFactor(self, factor): 设置切片标签臂的长度。该因数是相对于扇形半径的。1.0表示距离与半径相同。0.5表示该距离是半径的一半。默认距离为0.15。
• setLabelBrush(self, brush): 设置用于绘制切片的标签和标签臂的笔刷。
• setLabelColor(self, color): 设置用于绘制切片标签的颜色。
• setLabelFont(self, font): 设置用于绘制标签文本的字体。
• setLabelPosition(self, position): 设置切片标签的位置。
• setLabelVisible(self, visible): 设置切片标签的是否可见。默认情况下，标签不可见。
• setPen(self, pen): 设置用于绘制切片边界的画笔。
• setValue(self, value): 设置切片与饼图中所有切片的总和相比的百分比。实际值范围是0.0到1.0。将切片添加到系列后，将自动更新。

QPieSlice 常用信号：

• angleSpanChanged(self)：当切片的角度跨度发生变化时，将发出此信号。
• borderColorChanged(self)：当切片边界颜色更改时，将发射此信号。
• borderWidthChanged(self)：当切片边界宽度改变时，该信号被发射。
• brushChanged(self)：当用于填充切片的笔刷更改时，将发出此信号。
• clicked(self)：单击切片时会发出此信号。
• colorChanged(self)：当切片颜色改变时，该信号被发射。
• doubleClicked(self)：用户双击切片时会发出此信号。
• hovered(self,state)：当鼠标悬停在切片上时，将发出此信号。当鼠标移到切片上时，state变为True，而当鼠标再次移开时，state变为False。
• labelBrushChanged(self)：切片的标签笔刷更改时，将发出此信号。
• labelChanged(self)：切片标签更改时将发出此信号。
• labelColorChanged(self)：切片标签颜色更改时，将发出此信号。
• labelFontChanged(self)：当切片的标签字体更改时，将发出此信号。
• labelVisibleChanged(self)：切片标签的可见性更改时，将发出此信号。
• penChanged(self)：当用于绘制切片边界的笔改变时，将发出此信号。
• percentageChanged(self)：当切片的百分比发生变化时，将发出此信号。
• pressed(self)：当用户单击切片并按住鼠标按钮时，将发出此信号。
• released(self)：当用户释放切片上的鼠标按键时，将发出此信号。
• startAngleChanged(self)：切片的起始角度发生变化时，将发出此信号。
• valueChanged(self)：当切片值改变时，该信号被发射。

饼图演示

代码演示了一个简单的饼图显示效果，完整代码如下:

import sysfrom PyQt5.QtGui import QPainter, QPenfrom PyQt5.QtCore import Qtfrom PyQt5.QtWidgets import QApplication, QMainWindowfrom  PyQt5.QtChart import QChart, QChartView, QPieSeries, QPieSlice class DemoChartPieSeries(QMainWindow):    def __init__(self, parent=None):        super(DemoChartPieSeries, self).__init__(parent)                    # 设置窗口标题        self.setWindowTitle('实战 Qt for Python: QChart饼图演示')              # 设置窗口大小        self.resize(480, 360)               self.createChart()            def createChart(self):              #设置饼图数据        pieSeries = QPieSeries()        pieSeries.append('Jane', 1)        pieSeries.append('Joe', 2)        pieSeries.append('Andy', 3)        pieSeries.append('Barbara', 4)        pieSeries.append('Axel', 5)                #处理索引号为1的片        pieSlice = pieSeries.slices()[1]        pieSlice.setExploded()        pieSlice.setLabelVisible() #设置标签可见,缺省不可见        pieSlice.setPen(QPen(Qt.darkGreen, 2))        pieSlice.setBrush(Qt.green)                #创建图表        chart = QChart()        chart.addSeries(pieSeries)        chart.setTitle('简单的饼图示例')        chart.legend().hide()                #图表视图        chartView = QChartView(chart)        chartView.setRenderHint(QPainter.Antialiasing)                self.setCentralWidget(chartView)              if __name__ == '__main__':    app = QApplication(sys.argv)    window = DemoChartPieSeries()    window.show()    sys.exit(app.exec())   

运行运行结果如下：

QChart饼图演示

甜甜圈图示例

使用一个去掉中心部分形成一个圈状饼图，演示一个甜甜圈的物质成分，完整代码如下：

import sysfrom PyQt5.QtCore import Qtfrom PyQt5.QtGui import QPainter, QFontfrom PyQt5.QtWidgets import QApplication, QMainWindowfrom  PyQt5.QtChart import QChart, QChartView, QPieSeries, QPieSlice class DemoChartDonut(QMainWindow):    def __init__(self, parent=None):        super(DemoChartDonut, self).__init__(parent)                    # 设置窗口标题        self.setWindowTitle('实战 Qt for Python: QChart甜甜圈图演示')              # 设置窗口大小        self.resize(480, 360)               self.createChart()            def createChart(self):               #设置饼图数据        pieSeries = QPieSeries()        pieSeries.setHoleSize(0.35)        pieSeries.append('蛋白质 4.2%', 4.2)        pieSlice = pieSeries.append('脂肪 15.6%', 15.6)        pieSlice.setExploded()        pieSlice.setLabelVisible() #设置标签可见,缺省不可见        pieSeries.append('其他 23.8%', 23.8)        pieSeries.append('碳水化合物 56.4%', 56.4)                #图表视图        chartView = QChartView()        chartView.setRenderHint(QPainter.Antialiasing)        chartView.chart().setTitle('柠檬汁甜甜圈(100克)')        chartView.chart().addSeries(pieSeries)        chartView.chart().legend().setAlignment(Qt.AlignBottom)        chartView.chart().setTheme(QChart.ChartThemeBlueCerulean)        chartView.chart().legend().setFont(QFont('Arial', 8)) #图例字体                self.setCentralWidget(chartView)              if __name__ == '__main__':    app = QApplication(sys.argv)    window = DemoChartDonut()    window.show()    sys.exit(app.exec())   

运行结果如下图：

甜甜圈的物质成分示意

本文知识点

• 饼图控制类QPieSeries。
• 饼图切片类QPieSlice。
• 绘制一个中空的饼图。
• 设置饼图的背景主题。
• 设置饼图的图例。

前一篇： 实战PyQt5: 134-数据可视化之QChart绘制折线图