PySide2学习记录(十三):QPainter

Python版本3.7
PySide2 Version: 5.14.1
官方文档：http://doc.qt.io/qtforpython/index.html

如果要进行绘图操作，就需要了解一下QPainter类和QPaintDevice类。QPainter类的对象主要用于执行具体的操作，比如画一条直线，画一个圆，画一幅图像等等。QPaintDevice类代表可以进行绘制的类，所有你在界面上能看见的控件都可以是一个QPaintDevice(因为都是可以绘制的)，实际上所有可见的控件都继承了QPaintDevice类。这么多种类的设备该如何统一进行绘制，就需要QPaintEngine类提供统一的接口，一般都是在QPainter和QPaintDevice内部进行使用，一般情况下对我们都是透明的(不用太在意这个类)。

既然可见控件都是一个可以绘图的设备，那么应该在哪里进行自定义绘制，看下面一个例子。

from PySide2.QtWidgets import QWidget, QApplication
from PySide2.QtGui import QPainter, QBrush, QColor
from PySide2.QtCore import Qt, QRect


class MyWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setFixedSize(300, 200)

    def paintEvent(self, event):
        # 注意设置对象，不然painter不知道在哪画
        painter = QPainter(self)
        # 下面两行等效上面一行
        # painter = QPainter()
        # painter.begin(self)
        
        # 设置蓝色的画笔
        painter.setPen(Qt.blue)
        rectangle = QRect(10, 20, 80, 60)
        # 绘制矩形区域
        painter.drawRect(rectangle)
        # 填充矩形区域，使用蓝色的刷子
        painter.fillRect(rectangle, QBrush(QColor(Qt.blue)))


app = QApplication()
window = MyWidget()
window.show()
app.exec_()

运行截图:

图1

注意对于上面的例子，当绘图设备是一个widget的时候，QPainter只能在绘图事件中(paintEvent)中进行使用。判断当前painter是否可用可以使用QPainter类里面提供的isActive()函数，如果可用会返回True，否则False。在其它一些地方可能会看见使用begin(arg_1)方法，该方法传入一个需要绘制设备的对象，表示准备在该设备上进行绘图，结束绘图可以调用end()，一般情况下，释放painter时会自动进行调用。通过自定义绘图，我们便可以设计出各种漂亮的控件。
什么时候会调用paintEvent？当repaint()或update()函数被调用的时候，系统会调用paintEvent。

再来看一个例子:

from PySide2.QtWidgets import QApplication, QLabel
from PySide2.QtGui import QPixmap, QPainter
from PySide2.QtCore import QRect


app = QApplication()
# 生成一个QPixmap对象
image = QPixmap('image.jpg')
painter = QPainter()
painter.begin(image)
rectangle = QRect(100, 150, 100, 100)
painter.drawRect(rectangle)
painter.end()
label = QLabel()
# 设置标签起始位置和大小
label.setGeometry(50, 50, 800, 800)
# 用来设置图像
label.setPixmap(image)
label.show()
app.exec_()

image.jpg图片如下：

图2

效果图：

图3

看左上角，在这个图像上画了一个矩形。
因为这个绘图是直接在图像上绘图，而不是在widget上(代码中的label只是用来显示)，所以可以在paintEvent以外进行操作。

友情链接
QPainter
QPaintDevice
QPaintEngine
QPixmap