自定义可拖拽QWidget被另一QWidget刮花的问题排查

我子类化了QWidget并重写paintEvent()，只绘制一个圆角矩形；同时重写了mousePressEvent、mouseMoveEvent、mouseReleaseEvent，让Rectangle类的实例可以被鼠标拖拽。之后我创建了两个Rectangle实例并显示在父QWidget中，它们能正常显示和移动，但当拖拽一个矩形到另一个上方时，下方的矩形会出现围绕拖拽矩形的模糊灰边，拖拽离开后还会留下刮痕。我在paintEvent中添加调试信息后发现，拖拽时两个Rectangle的paintEvent都会执行。

（问题效果：拖拽粉色矩形覆盖蓝色矩形时，蓝色矩形会出现围绕粉色矩形的模糊灰边，拖拽离开后蓝色矩形上残留刮痕）

核心问题 #

• 局部重绘范围限制：你在paintEvent中使用e->rect()作为绘制范围，但圆角矩形的抗锯齿半透明像素会超出这个局部区域，重绘时边缘无法被正确清理，留下残留痕迹。
• 背景未正确清除：QWidget默认不会自动清除背景，当窗口区域被覆盖后重绘，旧像素未完全覆盖，形成刮痕。

具体修复步骤 #

1. 重绘整个Widget而非局部区域 #

把paintEvent中e->rect()替换为this->rect()，确保每次重绘覆盖整个Widget区域，包括抗锯齿边缘的像素：

void Rectangle::paintEvent(QPaintEvent *e){
    if(!e) return;
    QPainter painter(this);
    painter.setRenderHint(QPainter::Antialiasing);
    painter.setPen(Qt::NoPen);
    painter.setBrush(QColor(mColorName));
    // 替换局部重绘范围为整个控件区域
    const auto rect = this->rect();
    painter.drawRoundedRect(rect,8,8);
    qDebug() << "drawing rect:" << rect << ",name:" << mColorName;
}

2. 设置控件背景透明或自动填充背景 #

在Rectangle构造函数中添加背景处理代码，让Qt正确清理控件区域：

Rectangle::Rectangle(const QString & name,QWidget *parent) : QWidget(parent),mColorName(name)
{
    mPressing = false;
    // 方案1：设置透明背景，适合圆角透明控件
    setAttribute(Qt::WA_TranslucentBackground);
    
    // 方案2：如果不需要透明，用自动填充背景+匹配父窗口背景色
    // setAutoFillBackground(true);
    // QPalette pal = palette();
    // pal.setColor(QPalette::Background, parent->palette().color(QPalette::Background));
    // setPalette(pal);
}

• 方案1的Qt::WA_TranslucentBackground会让Qt在重绘前彻底清理整个控件区域，包括边缘半透明像素，完美解决刮痕问题。
• 方案2适合需要不透明背景的场景，通过自动填充背景覆盖旧像素。

3. 优化拖拽重绘效率（可选） #

拖拽时频繁重绘可能影响性能，可以在mouseMoveEvent中让父窗口更新相关区域：

void Rectangle::mouseMoveEvent(QMouseEvent* e){
    if(!e || !mPressing) return;
    QRect oldGeometry = geometry(); // 记录移动前的位置
    auto pos = mapToParent(e->pos()) - mPressPos;
    move(pos);
    // 让父窗口更新旧位置和新位置，避免残留
    parentWidget()->update(oldGeometry);
    parentWidget()->update(geometry());
}

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