PyQt6中自定义Widget作为QMainWindow中心部件出现间隙的原因与解决方法

问题描述 #

将自定义Widget作为QMainWindow的CentralWidget时，自定义部件与窗口之间出现明显间隙，但直接使用原生QWidget作为中心部件时无此视觉效果。复现代码如下：

from PyQt6.QtWidgets import QApplication, QWidget, QMainWindow, QLabel, QHBoxLayout
import sys


class MyWidget(QWidget):
    def __init__(self):
        super().__init__()
        self._layout = QHBoxLayout(self)
        self.label = QLabel("hello")
        self.label.setStyleSheet("QLabel {color: white;}")
        self._layout.addWidget(self.label)
        self.setStyleSheet("background-color: black; color: white;")


class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        # 使用自定义Widget时出现间隙
        self.central_widget = MyWidget()

        # 使用原生QWidget时无视觉间隙（未设置背景色时）
        # self.central_widget = QWidget()
        # self.central_layout = QHBoxLayout()
        # self.central_layout.addWidget(QLabel("hello"))
        # self.central_widget.setLayout(self.central_layout)

        self.setCentralWidget(self.central_widget)
        # 若给原生QWidget设置同样背景色，也会出现间隙
        # self.central_widget.setStyleSheet("background-color: black; color: white; border: none;")


if __name__ == '__main__':
    app = QApplication(sys.argv)
    win = MainWindow()
    win.show()
    sys.exit(app.exec())

原因分析 #

间隙的核心原因是QBoxLayout的默认布局边距：

• 自定义Widget中，通过QHBoxLayout(self)直接将布局绑定到Widget时，QHBoxLayout默认带有非零的内容边距（通常为9px上下左右）。
• 测试原生QWidget时，由于未给Widget设置背景色，布局边距被窗口背景覆盖，视觉上看不到间隙；若给原生QWidget添加同样的黑色背景样式，会出现完全相同的间隙。

解决方法 #

方法1：清除布局的默认边距 #

在自定义Widget的布局初始化后，调用setContentsMargins()移除布局的边距：

class MyWidget(QWidget):
    def __init__(self):
        super().__init__()
        self._layout = QHBoxLayout(self)
        self._layout.setContentsMargins(0, 0, 0, 0)  # 清除布局边距
        self.label = QLabel("hello")
        self.label.setStyleSheet("QLabel {color: white;}")
        self._layout.addWidget(self.label)
        self.setStyleSheet("background-color: black; color: white;")

方法2：设置Widget的内容边距（可选） #

也可以直接给自定义Widget设置内容边距，效果类似：

class MyWidget(QWidget):
    def __init__(self):
        super().__init__()
        self.setContentsMargins(0, 0, 0, 0)  # 清除Widget的内容边距
        self._layout = QHBoxLayout(self)
        self.label = QLabel("hello")
        self.label.setStyleSheet("QLabel {color: white;}")
        self._layout.addWidget(self.label)
        self.setStyleSheet("background-color: black; color: white;")

两种方法都能彻底消除自定义Widget与QMainWindow之间的间隙，推荐优先修改布局的边距，因为这是间隙的直接来源。

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