PyQt6/PySide6 QPainter 类

PyQt6/PySide6 QPainter 类深度解析

一、QPainter 基础

1.1 核心作用

QPainter 是 Qt 框架中用于执行 2D 图形绘制的核心类，可应用于：

• 自定义控件绘制
• 图像处理（QPixmap/QImage）
• 打印设备操作
• OpenGL 绘制上下文（需要 QOpenGLPaintDevice）

1.2 初始化与基本使用

在 widget 的 paintEvent 中创建 painter 对象：

from PyQt6.QtWidgets import QWidget
from PyQt6.QtGui import QPainter, QPen
from PyQt6.QtCore import Qt

class MyWidget(QWidget):
    def paintEvent(self, event):
        painter = QPainter(self)  # 创建并绑定到当前 widget
        painter.setPen(QPen(Qt.GlobalColor.blue, 2))  # 设置蓝色 2px 画笔
        painter.drawLine(10, 10, 100, 50)  # 绘制线段

二、绘图操作详解

2.1 基本图形绘制

线段绘制

painter.drawLine(20, 30, 200, 150)  # 从 (20,30) 到 (200,150)
painter.drawLines([QLine(10,10,50,50), QLine(50,50,100,30)])  # 多线段

矩形绘制

# 空心矩形
painter.drawRect(50, 50, 100, 80)  # (x, y, width, height)

# 圆角矩形
painter.drawRoundedRect(50, 50, 100, 80, 10, 10)  # x半径, y半径

椭圆/圆形

painter.drawEllipse(100, 100, 80, 80)  # 圆形
painter.drawEllipse(QPoint(150