macOS下带半透明背景的QMainWindow布局控件隐藏重绘问题

问题描述 #

在Qt 6.5.1中，给QMainWindow设置Qt::WA_TranslucentBackground属性后，隐藏布局内的控件（如示例中的btn2），会出现布局或背景未重绘、残留按钮阴影的问题。尝试过removeWidget、delete btn2、btnsLayout->update()、MainWindow::update()、repaint()等方法均无效，仅通过隐藏再显示整个主窗口能临时解决，但需要更轻量的优化方案。

示例代码 #

MainWindow.h #

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include "QtWidgets/qboxlayout.h"
#include "QtWidgets/qpushbutton.h"
#include "ui_mainwindow.h"
#include <QMainWindow>

QT_BEGIN_NAMESPACE
namespace Ui
{
class MainWindow;
}
QT_END_NAMESPACE

class MainWindow : public QMainWindow
{
    Q_OBJECT
    QWidget *centralWidget;
    QVBoxLayout *btnsLayout;
    QPushButton *btn1;
    QPushButton *btn2;

    Ui::MainWindow *ui;

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

        setWindowFlags(Qt::CustomizeWindowHint | Qt::FramelessWindowHint | Qt::Window);
        setAttribute(Qt::WA_NoSystemBackground, true);
        setAttribute(Qt::WA_TranslucentBackground, true);

        btn1 = new QPushButton("btn1", this);
        btn2 = new QPushButton("btn2", this);
        btnsLayout = new QVBoxLayout;
        btnsLayout->addWidget(btn1);
        btnsLayout->addWidget(btn2);

        connect(btn1, &QPushButton::clicked, this, &MainWindow::onBtnClick);

        centralWidget = new QWidget(this);
        centralWidget->setLayout(btnsLayout);

        setCentralWidget(centralWidget);
    }
    ~MainWindow() { delete ui; }

  public slots:
    void onBtnClick(bool)
    {
        btn2->hide();

        // works!
        // setVisible(false);
        // setVisible(true);
    }
};
#endif // MAINWINDOW_H

解决方案 #

方案1：调用窗口句柄的更新方法 #

对于启用半透明背景的顶层窗口，直接调用窗口句柄的update()可以触发底层合成器重新渲染整个窗口，比全局隐藏显示更高效：

void onBtnClick(bool)
{
    btn2->hide();
    if (auto windowHandle = this->windowHandle()) {
        windowHandle->update();
    }
}

方案2：调整centralWidget的背景属性 #

移除主窗口的Qt::WA_NoSystemBackground属性，并给centralWidget也设置半透明背景，避免重绘逻辑冲突：

// 在构造函数中修改属性设置
setWindowFlags(Qt::CustomizeWindowHint | Qt::FramelessWindowHint | Qt::Window);
// 移除WA_NoSystemBackground，避免干扰半透明背景的重绘逻辑
// setAttribute(Qt::WA_NoSystemBackground, true);
setAttribute(Qt::WA_TranslucentBackground, true);

centralWidget = new QWidget(this);
centralWidget->setAttribute(Qt::WA_TranslucentBackground, true); // 给centralWidget也设置半透明
centralWidget->setLayout(btnsLayout);

方案3：组合布局激活+层级重绘 #

先强制布局重新计算几何，再依次重绘centralWidget和主窗口：

void onBtnClick(bool)
{
    btn2->hide();
    btnsLayout->activate(); // 强制布局更新
    centralWidget->repaint();
    this->repaint();
}

说明 #

上述方案中，方案1通常是最有效且轻量的，因为它直接触发了窗口合成层的更新，绕过了普通widget重绘可能存在的缓存问题。方案2则从根源上调整了背景属性设置，避免了重绘逻辑冲突。

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