PyQt6实现PDF阅读器叠加矩形绘制功能遇阻求助

核心问题定位 #

加载PDF后无法绘制矩形，通常是层级覆盖或绘制目标错误导致的，和QPixmap/QPainter的参数、堆叠布局的用法直接相关。

具体修正方案 #

1. 堆叠布局的正确配置 #

堆叠布局默认只显示单个控件，必须设置StackAll让PDF层和绘制层同时显示，且绘制层要设为透明背景：

// 初始化PDF显示控件（比如用QLabel加载PDF页）
QLabel* pdfDisplay = new QLabel(this);
pdfDisplay->setScaledContents(true);

// 自定义绘制层Widget
class DrawLayer : public QWidget {
    QList<QRect> m_rects;
    bool m_drawing = false;
    QRect m_tempRect;
protected:
    void paintEvent(QPaintEvent*) override {
        QPainter p(this);
        p.setPen(QPen(Qt::blue, 2));
        p.setBrush(Qt::transparent); // 关键：透明填充不遮挡PDF
        for(auto& rect : m_rects) p.drawRect(rect);
        if(m_drawing) p.drawRect(m_tempRect);
    }
    void mousePressEvent(QMouseEvent* e) override {
        m_tempRect.setTopLeft(e->pos());
        m_drawing = true;
    }
    void mouseMoveEvent(QMouseEvent* e) override {
        if(m_drawing) {
            m_tempRect.setBottomRight(e->pos());
            update();
        }
    }
    void mouseReleaseEvent(QMouseEvent*) override {
        m_rects.append(m_tempRect.normalized());
        m_drawing = false;
        update();
    }
};

DrawLayer* drawLayer = new DrawLayer(this);
drawLayer->setAttribute(Qt::WA_TranslucentBackground); // 开启透明背景
drawLayer->setAutoFillBackground(false);
drawLayer->setMouseTracking(true);

// 配置堆叠布局
QStackedLayout* stackLayout = new QStackedLayout(this);
stackLayout->addWidget(pdfDisplay);
stackLayout->addWidget(drawLayer);
stackLayout->setStackingMode(QStackedLayout::StackAll); // 必须设置此模式

2. 避免错误的绘制方式 #

• 不要直接修改PDF显示控件的QPixmap：加载PDF后再绘制到这个QPixmap上，会被后续PDF页刷新覆盖，而且无法实时交互绘制
• 绘制操作必须在独立的上层Widget的paintEvent中完成，确保每次重绘都能保留已绘制的矩形

3. 额外排查点 #

• 检查绘制层的大小是否和PDF显示层一致：可以在resizeEvent中同步绘制层的尺寸到PDF显示层的大小
• 确认没有给绘制层设置不透明的样式表，否则会遮挡下方的PDF

内容的提问来源于stack exchange，提问作者Andrzej