如何在Qt组件默认绘制内容之上叠加绘制边框？

问题分析 #

用事件过滤器监听QEvent::Paint事件绘制边框时，QFrame/QWidget能正常显示边框，但QLineEdit、QPushButton等控件的边框会被自身绘制内容覆盖。核心原因是事件过滤器中先执行了自定义绘制，随后控件自身的Paint事件触发，覆盖了之前的绘制结果。

解决方法 #

调整绘制顺序，先让控件完成自身的绘制逻辑，再执行叠加绘制：

• 捕获QEvent::Paint事件时，先调用父类事件处理函数，让控件完成自身绘制
• 创建QPainter在控件上叠加绘制边框
• 返回true避免事件被重复处理

修改后的代码 #

EventFilter实现 #

bool MainWindow::eventFilter(QObject* obj, QEvent* event)
{
    if (event->type() == QEvent::Paint)
    {
        // 先让目标组件完成自身绘制
        QWidget::eventFilter(obj, event);
        
        QWidget* widget = qobject_cast<QWidget*>(obj);
        if (widget)
        {
            QPainter painter(widget);
            painter.setRenderHint(QPainter::Antialiasing, true);
            painter.setPen(QPen(QColor(Qt::red), 2));
            // 调整矩形避免边框被控件边缘裁剪
            painter.drawRoundedRect(widget->rect().adjusted(1, 1, -1, -1), 12, 12);
        }
        // 返回true，阻止事件继续传递（已完成绘制）
        return true;
    }

    return QWidget::eventFilter(obj, event);
}

主窗口初始化代码（保持原有逻辑） #

MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindowClass())
{
    ui->setupUi(this);

    QFrame* frame = new QFrame(this);
    frame->setGeometry(0, 30, 200, 32);
    frame->installEventFilter(this);
    frame->setStyleSheet("background-color: blue; border-radius: 12px;");
    frame->show();

    QLineEdit* lineEdit = new QLineEdit(this);
    lineEdit->setGeometry(0, 90, 200, 32);
    lineEdit->installEventFilter(this);
    lineEdit->setStyleSheet("background-color: blue; border-radius: 12px;");
    lineEdit->show();
}

补充说明 #

• 该方法对使用Qt StyleSheet绘制的控件同样有效，自定义绘制会在StyleSheet绘制之后执行
• 若需临时显示边框，可添加开关变量控制绘制逻辑，减少不必要的性能消耗

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