饼图是数据可视图表的基本类型,在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())
运行运行结果如下:
甜甜圈图示例
使用一个去掉中心部分形成一个圈状饼图,演示一个甜甜圈的物质成分,完整代码如下:
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绘制折线图