饼图是数据可视图表的基本类型，在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 sys
from PyQt5.QtGui import QPainter, QPen
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QApplication, QMainWindow
from  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())   

运行运行结果如下：

甜甜圈图示例

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

import sys
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QPainter, QFont
from PyQt5.QtWidgets import QApplication, QMainWindow
from  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图表之折线图