pyqt使用QChartView绘制饼状图详解（QPieSeries）

pyqt使用QChartView绘制柱状图一、工程搭建二、QPieSeries详解1、核心概念2、主要功能和方法2.1、QPieSeries 的常用方法2.2、QPieSlice 的常用属性和方法3、关键点解释4、常见问题二、代码示例1、示例代码2、效果展示一、工程搭建pyqt6QtCharts模块需要单独安装只安装pyqt6是不包含图表功能的。二、QPieSeries详解QPieSeries是 PyQt6 的QtCharts模块中的一个类专门用于创建和显示饼图。饼图是一种常见的图表类型用于展示数据各部分占整体的比例关系通常以圆形切片的形式呈现。1、核心概念系列 (QPieSeries):它是饼图数据的主要载体。你可以向这个系列中添加多个QPieSlice对象。它管理这些切片、计算它们的角度基于数值大小和总和、处理切片的状态如是否被突出显示以及图例等信息。切片 (QPieSlice):代表饼图中的一块扇形区域。每个切片包含value: 该切片代表的数值。label: 显示在切片上或其附近的文本标签如类别名称。exploded: 布尔值表示该切片是否被“炸开”即从饼图中心稍微移开以突出显示。样式属性如颜色 (color)、标签字体 (labelFont)、标签可见性 (labelVisible)、标签位置 (labelPosition)、标签格式 (labelArmLengthFactor、labelBorderColor等。切片可以响应点击等信号。图表 (QChart):是容纳各种图表系列如QPieSeries,QLineSeries,QBarSeries的容器。负责图表的整体布局、标题、图例位置、动画效果等。图表视图 (QChartView):是一个QWidget用于在 GUI 窗口中显示QChart对象。它处理用户交互如缩放、平移虽然饼图通常不需要平移。2、主要功能和方法2.1、QPieSeries的常用方法append(label, value): 添加一个切片。label是字符串标签value是数值。返回新创建的QPieSlice对象。append(slice): 直接添加一个已创建的QPieSlice对象。insert(index, slice): 在指定索引位置插入一个切片。remove(slice): 移除指定的切片。take(slice): 移除切片但不删除它返回该切片。clear(): 移除所有切片。slices(): 返回包含所有切片的列表。count(): 返回切片数量。sum(): 返回所有切片数值的总和。setHoleSize(holeSize): 设置饼图中心的孔洞大小0.0 表示实心饼图1.0 表示整个饼图消失。值在 [0.0, 1.0] 范围内。setPieSize(pieSize): 设置饼图相对于图表绘图区域的大小1.0 表示尽可能大。值在 [0.0, 1.0] 范围内。setPieStartAngle(startAngle): 设置第一个切片的起始角度度数默认为 0°即 3 点钟方向。setPieEndAngle(endAngle): 设置最后一个切片的结束角度度数。与startAngle结合可创建半圆或扇形图。setLabelsVisible(visibleTrue): 控制所有切片的标签是否可见。setLabelsPosition(position): 设置所有切片的标签位置QPieSlice.LabelPosition枚举值。pressed.connect(slot): 连接信号当用户按下饼图中的某个切片时触发。槽函数会接收到被按下的QPieSlice对象。released.connect(slot): 连接信号当用户释放按下的切片时触发。clicked.connect(slot): 连接信号当用户点击切片时触发。doubleClicked.connect(slot): 连接信号当用户双击切片时触发。hovered.connect(slot): 连接信号当鼠标悬停在切片上时触发。槽函数接收切片对象和一个布尔值表示是进入True还是离开False悬停状态。added(slices): 信号当切片被添加到系列时触发。removed(slices): 信号当切片从系列中移除时触发。2.2、QPieSlice的常用属性和方法value()/setValue(value): 获取/设置切片代表的数值。改变数值会自动重新计算饼图。label()/setLabel(label): 获取/设置切片的文本标签。isLabelVisible()/setLabelVisible(visibleTrue): 获取/设置该切片的标签是否可见会覆盖系列的全局设置。labelPosition()/setLabelPosition(position): 获取/设置该切片的标签位置QPieSlice.LabelPosition枚举值。QPieSlice.LabelOutside: 标签在饼图外默认。QPieSlice.LabelInside: 标签在饼图内。QPieSlice.LabelInsideHorizontal: 标签在饼图内水平方向。QPieSlice.LabelInsideTangential: 标签在饼图内切线方向。QPieSlice.LabelInsideNormal: 标签在饼图内法线方向。labelFont()/setLabelFont(font): 获取/设置标签的字体 (QFont)。labelBrush()/setLabelBrush(brush): 获取/设置标签的画笔 (QBrush用于文本填充)。labelColor()/setLabelColor(color): 获取/设置标签的颜色设置labelBrush更灵活。borderColor()/setBorderColor(color): 获取/设置切片边框的颜色。borderWidth()/setBorderWidth(width): 获取/设置切片边框的宽度。color()/setColor(color): 获取/设置切片的填充颜色。isExploded()/setExploded(explodedTrue): 获取/设置该切片是否被“炸开”。explodedDistanceFactor()/setExplodedDistanceFactor(factor): 获取/设置“炸开”距离的因子相对于饼图半径。percentage(): 计算并返回该切片数值占总和的比例小数形式如 0.25 表示 25%。startAngle(): 返回该切片的起始角度度数。angleSpan(): 返回该切片占据的角度范围度数。pressed.connect(slot),released.connect(slot),clicked.connect(slot),doubleClicked.connect(slot): 与QPieSeries的同名信号类似但只针对这个特定切片触发。3、关键点解释导入模块: 确保导入了QChart,QChartView,QPieSeries,QPieSlice以及必要的 GUI 和核心模块。创建QPieSeries: 这是存储饼图数据的核心对象。添加切片: 使用append(label, value)方法添加数据点。它会创建并返回一个QPieSlice对象方便后续自定义。自定义切片: 通过返回的QPieSlice对象可以设置颜色、标签位置、是否炸开、边框样式等。创建QChart: 图表容器。将系列添加到图表中并设置标题、动画等全局属性。创建QChartView: 用于在窗口中显示图表的部件。设置setRenderHint(QPainter.Antialiasing)可以使图形边缘更平滑。信号连接:QPieSlice可以响应点击 (clicked)、悬停 (hovered)、按下 (pressed)、释放 (released) 等信号实现交互功能。QPieSeries也有类似的信号但作用于整个系列内的任意切片。布局: 将QChartView设置为主窗口的中心部件或其他布局管理器的子部件。4、常见问题饼图不显示检查是否将QPieSeries添加到了QChart中 (chart.addSeries(series))。检查是否将QChart设置给了QChartView(QChartView的构造函数或setChart方法)。检查QChartView是否被添加到了窗口的布局中或设置为中央部件。切片标签不显示检查QPieSeries.setLabelsVisible(True)或QPieSlice.setLabelVisible(True)。检查标签位置 (setLabelPosition) 是否合适有时标签可能因位置或大小问题被遮挡。检查标签字体颜色是否与背景色对比度足够。二、代码示例1、示例代码importmathimportrandomimportsysfromPyQt6.QtCoreimportQt,QTimer,QPointFfromPyQt6.QtGuiimportQPainter,QPen,QColor,QFontfromPyQt6.QtWidgetsimportQApplication,QMainWindow,QPushButton,QLabel,QSpinBox,QWidget,QHBoxLayout,QVBoxLayout,\ QMessageBoxfromPyQt6.QtChartsimportQChart,QChartView,QLineSeries,QValueAxis,QSplineSeries,QBarSet,QBarSeries,\ QCategoryAxis,QPieSlice,QPieSeriesclassChartWindow(QMainWindow):def__init__(self):super().__init__()self.setWindowTitle(PyQt6 饼状图完美运行示例)self.resize(900,700)self.setStyleSheet(background-color: #f8f9fa;)# 1. 初始化基础数据 # 初始分类与占比6个分类总和100self.categories[产品A,产品B,产品C,产品D,产品E,产品F]self.init_values[25,18,22,15,10,10]# 颜色配置工业风配色区分度高self.colors[QColor(255,99,71),# 番茄红QColor(60,179,113),# 海草绿QColor(30,144,255),# 道奇蓝QColor(255,165,0),# 橙色QColor(128,0,128),# 紫色QColor(240,128,128)# 浅珊瑚色]# 2. 创建饼图系列核心 self.pie_seriesQPieSeries()self.pie_series.setHoleSize(0.2)# 中间空心大小0-10为实心self.init_pie_data()# 初始化饼图数据# 3. 创建图表容器 self.chartQChart()self.chart.addSeries(self.pie_series)self.chart.setTitle(产品销量占比分析)self.chart.setTitleFont(QFont(微软雅黑,16,QFont.Weight.Bold))self.chart.setAnimationOptions(QChart.AnimationOption.SeriesAnimations)# 加载动画self.chart.legend().setVisible(True)self.chart.legend().setAlignment(Qt.AlignmentFlag.AlignRight)# 图例位置self.chart.legend().setFont(QFont(微软雅黑,10))# 4. 创建ChartView显示图表 self.chart_viewQChartView(self.chart)self.chart_view.setRenderHint(QPainter.RenderHint.Antialiasing)# 抗锯齿self.chart_view.setInteractive(True)# 启用鼠标交互旋转/缩放# 5. 控制控件 # 按钮self.refresh_btnQPushButton(随机更新数据)self.reset_btnQPushButton(恢复初始数据)self.animate_btnQPushButton(切换动画效果)self.hole_btnQPushButton(切换空心/实心)# 占比最大值设置self.max_labelQLabel(单类最大占比)self.max_spinQSpinBox()self.max_spin.setRange(30,80)self.max_spin.setValue(50)self.max_spin.setSuffix(%)# 按钮样式美化适配不同状态btn_style QPushButton { padding: 10px 20px; font-size: 12px; border-radius: 6px; background-color: #2196F3; color: white; border: none; margin: 5px; } QPushButton:disabled { background-color: #cccccc; } QPushButton:hover:enabled { background-color: #1976D2; } self.refresh_btn.setStyleSheet(btn_style.replace(#2196F3,#4CAF50).replace(#1976D2,#45a049))self.reset_btn.setStyleSheet(btn_style)self.animate_btn.setStyleSheet(btn_style.replace(#2196F3,#FF9800).replace(#1976D2,#F57C00))self.hole_btn.setStyleSheet(btn_style.replace(#2196F3,#F44336).replace(#1976D2,#D32F2F))# 绑定事件self.refresh_btn.clicked.connect(self.refresh_random_data)self.reset_btn.clicked.connect(self.reset_original_data)self.animate_btn.clicked.connect(self.toggle_animation)self.hole_btn.clicked.connect(self.toggle_hole)# 6. 布局 central_widgetQWidget()self.setCentralWidget(central_widget)# 顶部控制栏control_layoutQHBoxLayout()control_layout.addWidget(self.refresh_btn)control_layout.addWidget(self.reset_btn)control_layout.addWidget(self.animate_btn)control_layout.addWidget(self.hole_btn)control_layout.addWidget(self.max_label)control_layout.addWidget(self.max_spin)control_layout.addStretch()# 自动填充空白# 主布局main_layoutQVBoxLayout(central_widget)main_layout.addLayout(control_layout)main_layout.addWidget(self.chart_view,stretch1)# 占满剩余空间# 7. 初始状态配置 self.is_holeTrue# 标记是否空心self.animation_enabledTruedefinit_pie_data(self):初始化饼图数据安全方式# 清空系列避免重复添加self.pie_series.clear()# 逐个添加饼图切片foridx,(category,value)inenumerate(zip(self.categories,self.init_values)):slice_itemQPieSlice(category,value)# 设置切片样式slice_item.setColor(self.colors[idx])slice_item.setLabelVisible(True)# 显示标签slice_item.setLabelFont(QFont(微软雅黑,9))# 鼠标悬停提示# slice_item.setToolTip(f{category}{value}%)# 点击切片高亮slice_item.clicked.connect(lambdasslice_item:self.highlight_slice(s))self.pie_series.append(slice_item)defrefresh_random_data(self):随机更新饼图数据无崩溃self.refresh_btn.setEnabled(False)# 生成随机占比保证总和100max_valueself.max_spin.value()values[]remaining100# 前5个分类随机分配foriinrange(5):ifi4:valremainingelse:valrandom.randint(5,min(max_value,remaining-(5-i)*5))values.append(val)remaining-val# 第6个分类填充剩余值values.append(remaining)# 安全更新数据清空系列后重新添加self.pie_series.clear()foridx,(category,value)inenumerate(zip(self.categories,values)):slice_itemQPieSlice(category,value)slice_item.setColor(self.colors[idx])slice_item.setLabelVisible(True)slice_item.setLabelFont(QFont(微软雅黑,9))slice_item.clicked.connect(lambdasslice_item:self.highlight_slice(s))self.pie_series.append(slice_item)self.refresh_btn.setEnabled(True)defreset_original_data(self):恢复初始数据self.refresh_btn.setEnabled(False)self.init_pie_data()self.refresh_btn.setEnabled(True)deftoggle_animation(self):切换动画效果ifself.animation_enabled:self.chart.setAnimationOptions(QChart.AnimationOption.NoAnimation)self.animate_btn.setText(开启动画效果)else:self.chart.setAnimationOptions(QChart.AnimationOption.SeriesAnimations)self.animate_btn.setText(关闭动画效果)self.animation_enablednotself.animation_enableddeftoggle_hole(self):切换空心/实心ifself.is_hole:self.pie_series.setHoleSize(0.0)# 实心self.hole_btn.setText(切换为空心)else:self.pie_series.setHoleSize(0.2)# 空心self.hole_btn.setText(切换为实心)self.is_holenotself.is_holedefhighlight_slice(self,slice_item):点击切片高亮弹出提示放大切片# 重置所有切片大小forsinself.pie_series.slices():s.setExploded(False)s.setLabelFont(QFont(微软雅黑,9))# 高亮当前切片slice_item.setExploded(True)# 向外突出slice_item.setLabelFont(QFont(微软雅黑,10,QFont.Weight.Bold))# 弹出提示框QMessageBox.information(self,切片详情,f{slice_item.label()}{slice_item.value()}%)if__name____main__:appQApplication(sys.argv)windowChartWindow()window.show()sys.exit(app.exec())2、效果展示