程序员文章、书籍推荐和程序员创业信息与资源分享平台

网站首页 > 技术文章 正文

实战PyQt5: 134-QChart图表之折线图

hfteth 2025-07-08 18:20:52 技术文章 2 ℃

在PyQt5中,有一个轻量级的图表绘制库PyQtChart, 该模块提供了一组易于使用的图表组件。它使用Qt Graphics View Framework,因此图表可以轻松集成到用户界面中。PyQtChart未包含在PyQt缺省的安装包中,要使用它,需要另行安装,运行命令:

pip install PyQtChart

安装该模块, 就可以使用了。

在一个图表程序中通常包含三个基本构成部分:

  • 用于在屏幕上显示的部件QChartView。
  • 用于管理图表的类QChart。
  • 各种图表相关对象,如坐标轴,图例, 各种图形,折线,立方图,饼图等等。

QChart它管理不同类型系列和其他与图表相关的对象(如图例和轴)的图形表示。

QChartView

QChartView是一个独立的部件,它可以显示图表。其常用函数有:

  • chart(self): 返回指向关联图表的对象。
  • setChart(self, chart): 将当前图表设置为chart。新图表的所有权将传递到图表视图,并释放前一个图表的所有权。为避免内存泄漏,必须删除先前的图表。
  • rubberBand(self): 返回图表视图当前正在使用的橡皮筋(rubber)标志。
  • setRubberBand(self, rubberBands): 将橡皮筋标志设置为rubberBand。所选标志确定执行缩放的方式。注意:极坐标图不支持橡皮筋缩放。

枚举QChartView.RubberBand取值及含义:

  • QChartView.NoRubberBand (0x0): 未指定缩放区域,因此无法启用缩放。
  • QChartView.VerticalRubberBand (0x1): 橡皮筋水平锁定在图表的大小,可以垂直拉动以指定缩放区域。
  • QChartView.HorizontalRubberBand (0x2): 橡皮筋会垂直锁定到图表大小,并且可以水平拉动以指定缩放区域。
  • QChartView.RectangleRubberBand (0x3): 橡皮筋固定在被点击的位置,可以垂直和水平拉动。

QChart

QChart类管理一系列的图表,图例和坐标轴的图形表示。QChart是一个QGraphicsWidget,可以在QGraphicsScene中显示。它管理不同类型系列和其他与图表相关的对象(如图例和轴)的图形表示。为了仅在布局中显示图表,可以使用类QChartView代替QChart。此外,通过使用QPolarChart类,可以将折线,样条曲线,面积和散布序列表示为极坐标图。

QChart的常用函数:

  • addAxis(self.axis, alignment):将坐标轴axis添加到图表中,对齐方式是由alignment指定。图表(chart)获取坐标轴的所有权。
  • addSeries(self, series): 将图形序列series添加到图表中,图表获得图表序列的所有权。
  • removeAllSeries(self):从图表中删除所有添加到图表中的图形序列对象。
  • removeAxis(self, axis):从图表中删除坐标轴axis。图表将释放指定axis对象的所有权。
  • removeSeries(self,series):从图表中删除图形序列。图表将释放指定图形序列对象的所有权。
  • setAnimationDuration(self,msecs):设置图表动画持续时间。
  • setAnimationEasingCurve(self,curve):设置图表动画的擦除曲线。
  • setAnimationOptions(self,options): 启用或者禁用图表的动画选项。
  • setBackgroundBrush(self,brush):将用于绘制图表区域背景的画刷设置为brush
  • setBackgroundPen(self,pen):将用于绘制图表区域背景的画笔设置为pen
  • setBackgroundRoundness(self,diameter): 设置图表背景的在四个角处的圆角直径。
  • setBackgroundVisible(self,visible):设置图表绘图区域背景是否可见。
  • setDropShadowEnabled(self,enabled):设置是否启用背景阴影效果。
  • setLocale(self,locale):设置用于格式化各种图表标签的语言环境。
  • setLocalizeNumbers(self,localize):设置采用本地化的数字表示方式。
  • setMargins(self,margins): 设置图表矩形边缘和绘图区域之间允许的最小边距。
  • setPlotArea(self,rect):设置绘制图表的矩形区域。
  • setPlotAreaBackgroundBrush(self,brush): 将用于填充图表绘图区域背景的画刷设置为brush
  • setPlotAreaBackgroundPen(self,pen): 将用于绘制图表绘图区域背景的画笔设置为pen
  • setPlotAreaBackgroundVisible(self,visible):设置图表绘图区域背景是否可见。
  • setTheme(self,theme): 设置图表的主题。
  • setTitle(self,title): 设置图表的标题信息。
  • setTitleBrush(self,brush):将用于绘制标题文本的画刷设置为brush
  • setTitleFont(self,font):将用于绘制图表标题的字体设置为font

QChart的常用信号:

  • plotAreaChanged(self, plotArea):当绘图区域发生了改变,调用该信号。

QLineSeries

QLineSeries类将数据显示成折线图。折线图是将一系列数据点显示为通过直线连接的折线创建一个基本的折线代码如下:

series = QLineSeries()
series.append(0, 6)
series.append(2, 4)
...
chart.addSeries(series)

一个简单的折线图

测试样例绘制了一个简单的折线图,完整代码如下:

import sys
from PyQt5.QtGui import QPainter
from PyQt5.QtWidgets import QApplication, QMainWindow
from  PyQt5.QtChart import QChart, QChartView, QLineSeries
 
class DemoChartLineSeries(QMainWindow):
    def __init__(self, parent=None):
        super(DemoChartLineSeries, self).__init__(parent)   
        
         # 设置窗口标题
        self.setWindowTitle('实战 Qt for Python: QChart折线图演示')      
        # 设置窗口大小
        self.resize(480, 360)
        
        self.createChart()
    
    def createChart(self):
            
        #设置折线数据
        lineSeries = QLineSeries()
        lineSeries.append(0, 6)
        lineSeries.append(2, 4)
        lineSeries.append(3, 8)
        lineSeries.append(7, 4)
        lineSeries.append(10, 5)
        lineSeries.append(11, 1)
        lineSeries.append(13, 3)
        lineSeries.append(17, 6)
        lineSeries.append(18, 3)
        lineSeries.append(20, 2)
        
        #创建图表
        chart = QChart()
        chart.legend().hide()
        chart.addSeries(lineSeries)
        chart.createDefaultAxes()
        chart.setTitle('一个简单的折线图示例')
        
        #图表视图
        chartView = QChartView(chart)
        chartView.setRenderHint(QPainter.Antialiasing)
        
        self.setCentralWidget(chartView)
      
        
if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = DemoChartLineSeries()
    window.show()
    sys.exit(app.exec())   
    window = DemoChartLineSeries()
    window.show()
    sys.exit(app.exec())   

在Windows系统下的运行效果如下图:

在Ubuntu系统下的运行效果如下图:

本文知识点

  • PyQtChart模块未在PyQt5缺省包中,需要单独安装。
  • QChartView是一个用于显示图表的方便类。
  • QChart管理图表中的各种元素,如图例,坐标轴,各种图形序列。
  • QLineSeries绘制折线图。

前一篇: 实战PyQt5: 133-定制你的专属浏览器

最近发表
标签列表