PyQt 中重写 QPaintEvents

在本文中，我们将介绍如何在 PyQt 中重写 QPaintEvents。QPaintEvent 是 PyQt 中绘图事件的一种，允许我们自定义界面元素的外观和行为。通过重写 QPaintEvent，我们可以使用自定义的绘图逻辑来实现特定的效果。

阅读更多：PyQt 教程

什么是 QPaintEvent

QPaintEvent 是 QWidget 类的一个事件，用于在窗口部件的部分或全部区域需要重绘时触发。QPaintEvent 包含了一个绘图设备以及一个要绘制的矩形区域。通过重写 QPaintEvent，我们可以在指定的区域内进行绘图操作，从而达到自定义外观和行为的目的。

重写 QPaintEvent 步骤

要重写 QPaintEvent，我们需要按照以下步骤进行操作：

步骤一：创建自定义的 QWidget 子类

首先，我们需要创建一个自定义的 QWidget 子类，用于承载我们要重写的 QPaintEvent。例如，我们可以创建一个名为 MyWidget 的类继承自 QWidget。

class MyWidget(QWidget):
    def __init__(self):
        super().__init__()

    def paintEvent(self, event):
        # 在这里添加自定义的绘图逻辑
        pass

步骤二：重写 paintEvent 方法

在自定义的 QWidget 子类中，我们需要重写 paintEvent 方法。paintEvent 方法接收一个 QPaintEvent 参数，其中包含了绘图设备和要绘制的矩形区域。我们可以在这个方法中实现自定义的绘图逻辑。

在这个例子中，我们只是在指定的矩形区域绘制了一个红色的矩形。

def paintEvent(self, event):
    painter = QPainter(self)
    painter.fillRect(event.rect(), Qt.red)

步骤三：应用自定义的 QWidget 子类

最后一步是将自定义的 QWidget 子类应用到我们的应用程序中。我们可以通过将该自定义部件添加到应用程序的布局中或直接作为顶级窗口使用。以下是一个简单的示例：

if __name__ == "__main__":
    app = QApplication([])
    window = QMainWindow()
    widget = MyWidget()
    window.setCentralWidget(widget)
    window.show()
    app.exec_()

完成上述步骤后，我们就可以自定义绘制界面的外观和行为了。

示例：绘制自定义按钮

让我们通过一个示例来演示如何重写 QPaintEvent 来绘制自定义按钮。我们将创建一个按钮部件，当鼠标悬停在按钮上方时，按钮将变成蓝色。

from PyQt5.QtCore import Qt
from PyQt5.QtGui import QPainter
from PyQt5.QtWidgets import QApplication, QWidget

class CustomButton(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setMinimumSize(100, 50)
        self._hovered = False

    def enterEvent(self, event):
        self._hovered = True
        self.update()

    def leaveEvent(self, event):
        self._hovered = False
        self.update()

    def paintEvent(self, event):
        painter = QPainter(self)
        painter.setRenderHint(QPainter.Antialiasing)

        radius = min(self.width(), self.height()) / 2.0
        color = Qt.blue if self._hovered else Qt.gray

        painter.setBrush(color)
        painter.setPen(Qt.NoPen)
        painter.drawEllipse(self.rect().center(), radius, radius)

if __name__ == "__main__":
    app = QApplication([])
    button = CustomButton()
    button.show()
    app.exec_()

在上述示例中，我们创建了一个 CustomButton 类，继承自 QWidget。在鼠标进入和离开按钮部件时，我们设置 _hovered 标志为 True 或 False，并调用 update() 方法触发重绘。

在 paintEvent 方法中，我们使用 QPainter 对象绘制了一个圆形按钮。当 _hovered 标志为 True 时，按钮的颜色为蓝色，否则为灰色。