PyQt6：覆盖MainWindow的LoadingWidget出现边框留白问题求助

核心原因 #

• 父控件匹配错误：你将LoadingWidget的父控件设为MainWindow，但MainWindow的实际可交互内容区域是centralwidget，主窗口本身包含标题栏、系统边框等非内容区域，直接绑定到MainWindow会导致加载屏尺寸无法匹配真实内容区域。
• 布局与位置未对齐：LoadingWidget默认初始位置并非左上角，且内部布局存在默认边距，加上固定尺寸未匹配主窗口的客户区尺寸（除去标题栏的部分），最终出现未填充的边框。

修复方案 #

1. 优化LoadingWidget的自适应能力

修改LoadingWidget代码，移除固定尺寸，清除布局边距，让它自适应父控件大小：

class LoadingWidget(QWidget):
    def __init__(self, parent):
        super().__init__(parent)
        self.setStyleSheet("background-color: rgba(0, 0, 0, 150);")
        self.loading_label = QLabel(self)
        self.loading_label.setAlignment(Qt.AlignmentFlag.AlignCenter)
        
        # 移除固定尺寸，改为随父控件自适应
        # self.setFixedSize(1150, 700)
        
        movie = QMovie('interface\\icons\\loading.gif')
        self.loading_label.setMovie(movie)
        movie.start()
        
        layout = QVBoxLayout(self)
        # 清除布局默认边距，避免内部出现空白
        layout.setContentsMargins(0, 0, 0, 0)
        layout.addWidget(self.loading_label)

2. 正确绑定到centralwidget并覆盖全区域

在MainWindow的setupUi中，将LoadingWidget的父控件改为centralwidget，并设置它完全覆盖该区域：

class Ui_MainWindow(QMainWindow):
    def setupUi(self, MainWindow):
        MainWindow.setObjectName("MainWindow")
        MainWindow.setFixedSize(1150, 700)

        self.centralwidget = QWidget(parent=MainWindow)
        self.centralwidget.setObjectName("centralwidget")
        # 必须将centralwidget设置为主窗口的中心控件，确保它占据正确的内容区域
        MainWindow.setCentralWidget(self.centralwidget)
        
        # 创建LoadingWidget，父控件设为centralwidget
        self.loading_view = LoadingWidget(parent=self.centralwidget)
        # 设置LoadingWidget覆盖整个centralwidget
        self.loading_view.setGeometry(self.centralwidget.rect())

3. 可选：支持窗口大小动态调整（若后续需要）

如果之后要取消固定窗口尺寸，添加窗口大小变化的监听，让加载屏自动适配：

class Ui_MainWindow(QMainWindow):
    def setupUi(self, MainWindow):
        # ... 保留原有代码 ...
        
        # 绑定窗口 resize 事件
        MainWindow.resizeEvent = self.on_window_resize

    def on_window_resize(self, event):
        # 更新加载屏尺寸以匹配centralwidget
        self.loading_view.setGeometry(self.centralwidget.rect())
        # 调用父类的resizeEvent，保证主窗口正常处理其他逻辑
        super().resizeEvent(event)

使用提示 #

模型处理开始时调用self.loading_view.show()显示加载屏，处理完成后调用self.loading_view.hide()隐藏即可。

内容的提问来源于stack exchange，提问作者Pedro D. Souza