调用update()后QLabel的paintEvent()未触发的问题排查

首先，你的问题核心是继承QLabel的Shape控件没有被正确初始化和显示，导致update()/repaint()无法触发paintEvent，再加上QOpenGLWidget的渲染特性，才出现了看似paintEvent不执行的情况。下面拆解原因并给出修复方案：

核心问题原因 #

1. Shape控件无有效绘制区域：QLabel是QWidget子类，必须设置geometry（位置+大小）才能拥有可见的绘制区域。你只是把矩形参数存在m_rectangle里，但控件本身的大小是默认的0x0，系统不会为一个没有尺寸的控件触发重绘。
2. QPainter使用不当：你用成员变量m_painter来绘制，QPainter的生命周期应该和paintEvent绑定，成员变量可能残留旧状态，导致绘制异常。
3. 坐标转换错误：你在鼠标事件里把像素坐标转换成了网格坐标（基于m_cols/m_rows），但Shape需要的是父控件（GLWidget）的像素坐标，否则控件会被放在不可见的位置。
4. QOpenGLWidget与子控件的渲染冲突：QLabel的软件绘制可能被OpenGL的渲染内容覆盖，需要设置控件的透明背景属性。

分步修复方案 #

1. 修复Shape类的初始化与绘制逻辑 #

修改Shape的构造函数、draw方法和paintEvent，确保控件有有效区域，绘制逻辑正确：

// Shape.h 先确保声明了正确的成员变量
class Shape : public QLabel
{
    Q_OBJECT
public:
    Shape(const QColor& color, uint width, const QRect& rect, QWidget* parent = nullptr);
    void draw(const QRect& rect);

protected:
    void paintEvent(QPaintEvent* event) override;

private:
    QColor m_color;
    QRect m_rectangle;
    uint m_width;
    // 移除成员变量m_painter，改用局部变量
};

// Shape.cpp 实现
#include "Shape.h"
#include <QPainter>

Shape::Shape(const QColor& color, uint width, const QRect& rect, QWidget* parent)
    : QLabel(parent), m_color(color), m_rectangle(rect), m_width(width)
{
    // 关键：设置控件的位置和大小，让系统知道它的绘制区域
    setGeometry(rect);
    // 去掉默认背景，避免遮挡OpenGL内容
    setAttribute(Qt::WA_NoSystemBackground);
    // 清空默认文本，避免QLabel默认绘制文本干扰
    setText("");
    update();
}

void Shape::draw(const QRect& rect)
{
    m_rectangle = rect;
    // 同步更新控件的位置大小
    setGeometry(rect);
    update();
}

void Shape::paintEvent(QPaintEvent* /*event*/)
{
    // 使用局部QPainter，每次绘制都重新初始化，避免状态残留
    QPainter painter(this);
    QPen pen(m_color);
    pen.setWidth(m_width);
    painter.setPen(pen);
    // 绘制控件自身的矩形（因为geometry已经和m_rectangle一致，所以用rect()即可）
    painter.drawRect(rect());
}

2. 修正GLWidget的鼠标事件坐标逻辑 #

确保m_selection使用GLWidget的像素坐标，而不是转换后的网格坐标（如果需要网格坐标，可以单独存储，不要用来设置Shape的位置）：

// GLWidget.cpp 鼠标事件修改
void GLWidget::mousePressEvent(QMouseEvent* event)
{
    m_mousePressed = true;
    m_cursorPos = event->pos();
    // 网格坐标单独存储，不要用来设置Shape的位置
    QPoint gridPos(
        static_cast<int>((static_cast<double>(m_cursorPos.x()) / width()) * m_cols),
        static_cast<int>((static_cast<double>(m_cursorPos.y()) / height()) * m_rows)
    );
    // 用鼠标的像素坐标初始化选择区域
    m_selection.setTopLeft(m_cursorPos);
    m_selection.setBottomRight(m_cursorPos);
    m_rectangle.reset(new Shape(Qt::yellow, 2, m_selection, this));
}

void GLWidget::mouseMoveEvent(QMouseEvent* event)
{
    if (m_mousePressed)
    {
        m_selection.setBottomRight(event->pos());
        if (m_rectangle)
        {
            m_rectangle->draw(m_selection);
        }
    }
}

void GLWidget::mouseReleaseEvent(QMouseEvent* /*event*/)
{
    m_mousePressed = false;
    if (m_rectangle)
    {
        m_rectangle->draw(m_selection);
    }
}

3. 确保GLWidget的渲染流程正确 #

如果你重写了GLWidget的paintGL或paintEvent，记得不要跳过父类的实现，否则子控件的绘制会被忽略：

void GLWidget::paintGL()
{
    // 你的OpenGL渲染代码...
    glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
    // ...其他OpenGL绘制逻辑

    // 不需要额外操作，QOpenGLWidget会自动绘制子控件
}

// 如果重写了paintEvent，必须调用父类实现
void GLWidget::paintEvent(QPaintEvent* event)
{
    QOpenGLWidget::paintEvent(event); // 这一步是子控件绘制的关键
    // 你自己的额外绘制逻辑（如果有的话）
}

为什么这样能解决问题？ #

• 设置geometry后，Shape控件有了明确的位置和大小，系统会认为它需要被绘制，update()就能正确触发paintEvent。
• 局部QPainter避免了成员变量的状态污染，每次绘制都是干净的上下文。
• 透明背景属性让QLabel不会遮挡QOpenGLWidget的OpenGL渲染内容。
• 正确的像素坐标确保Shape控件出现在鼠标操作的位置，你能直观看到绘制效果。

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