自定义Qt Widget中paintEvent未被调用的问题排查求助

核心问题分析 #

你的代码中RenderArea::paintEvent未触发，同时存在坐标转换错误、内存泄漏风险等问题，以下是具体修复方案和机制解释：

1. 为什么paintEvent没触发？ #

Qt的paintEvent仅在Widget需要重绘时触发，比如首次显示、尺寸变化、调用update()/repaint()时。你的代码中调用了update()但仍未触发，核心原因是RenderArea未获得足够的显示空间：

• 你给tentFrame设置了布局，但RenderArea的默认sizePolicy不会自动扩展占满父容器空间，导致它可能被压缩到极小甚至不可见，自然不会触发重绘。

2. 关键修复步骤 #

修复RenderArea的布局空间问题

在RenderArea构造函数中设置尺寸策略，让它自动占满父容器：

RenderArea::RenderArea(QWidget* parent): QWidget(parent) {
    // 设置尺寸策略为可扩展，占满布局空间
    setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding);
    tableColor = QColor(0, 0, 255);
    pen.setColor(tableColor);
    pen.setWidth(2); // 增加边框宽度，确保可见
    brush.setColor(tableColor);
    brush.setStyle(Qt::SolidPattern);
}

修复坐标转换错误

TableMaker::mousePressEvent中获取的e->pos()是相对于主窗口的坐标，而RenderArea的绘图坐标是自身局部坐标，需要转换：

void TableMaker::mousePressEvent(QMouseEvent* e) {
    // 将主窗口坐标转换为RenderArea的局部坐标
    QPoint localPos = renderArea->mapFrom(this, e->pos());
    renderArea->addNewTable(localPos);
    renderArea->update();
}

消除内存泄漏

你用QVector<QRect*>存储矩形会导致内存泄漏，直接存储QRect对象即可：

// renderArea.h 修改容器类型
QVector<QRect> recs;

// renderArea.cpp 修改addNewTable和paintEvent
void RenderArea::addNewTable(QPoint p) {
    recs.append(QRect(p, QSize(100, 100)));
    update();
}

void RenderArea::paintEvent(QPaintEvent* e) {
    QWidget::paintEvent(e);
    QPainter p(this);
    p.setPen(pen);
    p.setBrush(brush);
    for (const QRect& r : recs) {
        p.drawRect(r);
    }
}

Qt绘图机制补充 #

• paintEvent触发时机：仅在Widget需要重绘时调用，包括：
  • Widget首次显示
  • Widget尺寸改变
  • 调用update()/repaint()
  • 被其他窗口遮挡后重新显示
• update()与repaint()区别：
  • update()将重绘请求加入事件队列，Qt会合并多个请求，避免频繁重绘，优先使用
  • repaint()会立即触发paintEvent，适合紧急重绘场景
• 坐标系统：每个Widget有独立的局部坐标（左上角为(0,0)），跨Widget的坐标需要用mapFromParent()/mapFromGlobal()转换

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