在许多需要对pdf文档进行标注或编辑的应用程序中，能够在pdf视图上直接绘制图形是一项基本需求。qt框架提供了qpdfview用于显示pdf文档，但其本身并不直接支持交互式绘图。为了实现这一功能，我们需要对其进行子类化，并结合qt的事件处理机制和绘图api。
理解QPdfView的绘图机制与挑战
QPdfView在内部使用一个视口（viewport）来渲染PDF内容。当我们尝试在其上进行自定义绘图时，通常会重写paintEvent方法。然而，直接调用self.update()（它会触发self.paintEvent）可能不会立即在PDF内容上显示我们绘制的图形，因为QPdfView的绘图区域可能被其内部的PDF渲染机制所覆盖，或者self.update()未能正确地通知其内部视口进行重绘。解决此问题的关键在于直接操作QPdfView的视口进行重绘。
实现交互式矩形绘制
我们将通过子类化QPdfView来实现一个名为CustomQPdfView的组件，它能够响应鼠标事件来绘制和调整矩形。
1. 定义绘图状态
为了管理矩形的绘制和编辑过程，我们需要定义几种状态：
# 定义绘图状态常量 FREE_STATE = 1 # 自由状态，未进行任何绘图操作 BUILDING_SQUARE = 2 # 正在绘制矩形 BEGIN_SIDE_EDIT = 3 # 正在编辑矩形的起始边（通常是左边） END_SIDE_EDIT = 4 # 正在编辑矩形的结束边（通常是右边）
2. 初始化CustomQPdfView
在CustomQPdfView的构造函数中，我们需要初始化绘制矩形的起始点和结束点，以及当前的绘图状态。同时，可以设置绘制矩形所使用的画笔样式。
from PyQt5.QtWidgets import QMainWindow, QApplication, QVBoxLayout, QWidget
from PyQt5.QtPdfWidgets import QPdfView
from PyQt5.QtPdf import QPdfDocument
from PyQt5.QtCore import QPoint, QRect, QUrl
from PyQt5.QtGui import QPainter, QColor, QPen
import sys
# ... (FREE_STATE, BUILDING_SQUARE等定义)
class CustomQPdfView(QPdfView):
def __init__(self, parent=None):
super().__init__(parent)
# 初始化矩形绘制的起始点和结束点
self.begin = QPoint()
self.end = QPoint()
# 初始化绘图状态为自由状态
self.state = FREE_STATE
# 设置矩形绘制的画笔：半透明红色，宽度为2
self.pen = QPen(QColor(255, 0, 0, 150))
self.pen.setWidth(2)
# 可选：设置组件的初始几何尺寸，如果需要的话
# self.setGeometry(30, 30, 600, 400) 3. 重写paintEvent方法
paintEvent是Qt组件进行绘制的核心方法。在这里，我们将在父类的绘图（即PDF内容的渲染）完成后，再绘制我们的自定义矩形。关键在于QPainter(self.viewport())，它确保我们的绘制操作是作用在QPdfView的内部视口上，而不是QPdfView组件本身。
def paintEvent(self, event):
super().paintEvent(event) # 首先调用父类的paintEvent，绘制PDF内容
# 创建一个QPainter，作用于QPdfView的视口
painter = QPainter(self.viewport())
painter.setPen(self.pen)
# 绘制矩形，如果起始点和结束点有效
if not self.begin.isNull() and not self.end.isNull():
# .normalized()确保QRect的top-left和bottom-right坐标是正确的，
# 无论用户从哪个方向拖动鼠标
painter.drawRect(QRect(self.begin, self.end).normalized())4. 处理鼠标事件
鼠标事件是实现交互式绘图的关键。我们将重写mousePressEvent、mouseMoveEvent和mouseReleaseEvent来捕获用户的鼠标操作。
mousePressEvent： 当鼠标按下时，根据当前鼠标位置判断是开始绘制新矩形，还是编辑现有矩形的边。为了提供更好的用户体验，我们设置了一个小的容差区域来检测边缘点击。
def mousePressEvent(self, event):
# 如果已经存在一个矩形，判断是否点击到其边缘进行编辑
if not self.begin.isNull() and not self.end.isNull():
p = event.pos()
rect = QRect(self.begin, self.end).normalized()
# 检查是否接近矩形的左边或右边，提供3像素的容差
if abs(rect.left() - p.x()) <= 3 and rect.top() <= p.y() <= rect.bottom():
self.state = BEGIN_SIDE_EDIT
return
elif abs(rect.right() - p.x()) <= 3 and rect.top() <= p.y() <= rect.bottom():
self.state = END_SIDE_EDIT
return
# 如果不是编辑现有矩形，则开始绘制新矩形
self.state = BUILDING_SQUARE
self.begin = event.pos()
self.end = event.pos()
# 注意：这里不需要立即调用repaint，因为mouseMoveEvent会处理后续的刷新apply_event辅助方法： 这个方法根据当前绘图状态更新矩形的begin和end点。它封装了不同状态下的点更新逻辑。
def apply_event(self, event):
if self.state == BUILDING_SQUARE:
self.end = event.pos()
elif self.state == BEGIN_SIDE_EDIT:
# 仅修改x坐标以调整左边
self.begin.setX(event.x())
elif self.state == END_SIDE_EDIT:
# 仅修改x坐标以调整右边
self.end.setX(event.x())mouseMoveEvent： 当鼠标移动时，如果处于绘图或编辑状态，则调用apply_event更新矩形坐标。最关键的一步是调用self.viewport().repaint() 来立即刷新视口，确保矩形的变化能够即时显示在PDF内容之上。
def mouseMoveEvent(self, event):
if self.state != FREE_STATE: # 只有在绘 
