QPainter绘制内容被QFrame样式表背景遮挡，如何置于控件上方？

问题原因 #

Qt的绘制顺序是父窗口先执行paintEvent，再由子控件依次执行自身的paintEvent。当你通过样式表给QFrame设置背景色时，QFrame会在自己的paintEvent中绘制这个背景，导致父窗口paintEvent里绘制的内容被QFrame的背景层覆盖。

解决方案：子类化QFrame重写paintEvent #

最直接可靠的方式是自定义QFrame子类，在其paintEvent中先绘制样式表背景，再绘制需要显示在上方的图形。

步骤1：定义CustomFrame子类 #

#include <QFrame>
#include <QPainter>

class CustomFrame : public QFrame
{
    Q_OBJECT
protected:
    void paintEvent(QPaintEvent *event) override
    {
        // 先调用父类paintEvent，绘制样式表设置的背景
        QFrame::paintEvent(event);

        // 绘制需要显示在上方的图形
        QPainter painter(this);
        painter.setPen(QPen(QColor(234, 33, 123), 20));
        
        // 计算相对于当前CustomFrame的绘制区域（根据需求调整）
        QRect rect = this->frameRect();
        rect.setY(this->height() / 2);
        rect.setHeight(5);
        rect.setWidth(this->width() * 1.5);
        
        painter.drawRect(rect);
    }
};

步骤2：替换原QFrame为CustomFrame #

• 如果用Qt Designer设计UI，选中原QFrame，右键选择「提升为...」，输入CustomFrame并添加，将其提升为自定义子类。
• 如果是代码创建控件，直接实例化CustomFrame替代QFrame。

替代方案：父窗口延迟绘制（不推荐） #

如果不想子类化，可以在父窗口的paintEvent中，先让子控件完成绘制，再执行自己的绘制逻辑。这种方式兼容性较差，可能导致绘制闪烁：

void PaintHelper::paintEvent(QPaintEvent *event)
{
    QWidget::paintEvent(event);
    
    // 强制子控件完成绘制
    ui->frame->paintEvent(event);

    // 再绘制图形
    QPainter painter(this);
    painter.setPen(QPen(QColor(234, 33, 123), 20));
    QRect rect = ui->frame->frameRect();
    rect.setY(ui->frame->parentWidget()->size().height() / 2);
    rect.setHeight(5);
    rect.setWidth(rect.width() * 1.5);
    painter.drawRect(rect);
}

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