求助：自定义QWidget无法在QGridLayout中显示的原因

你的自定义Toolbar继承自QWidget但无法在QGridLayout中显示，核心原因是空白QWidget默认没有任何可视化渲染内容，即使设置了最小高度，它也会和窗口背景完全融合，看起来像是未显示；而QTextEdit自带边框、背景等样式，所以能正常呈现。

修复方案 #

可以通过以下两种方式解决：

方案1：给Toolbar设置背景色

修改Toolbar类的初始化方法，添加背景样式让控件可见：

class Toolbar(QWidget):
    def __init__(
        self,
        parent: QWidget | None = None,
        flags: Qt.WindowType = Qt.WindowType.Widget,
    ) -> None:
        super().__init__(parent, flags)
        self.setMinimumHeight(50)
        # 添加背景色，使控件可视化
        self.setStyleSheet("background-color: #f0f0f0;")

方案2：重写paintEvent绘制自定义内容

如果需要实现更复杂的工具栏外观，可重写paintEvent方法手动绘制内容：

from PyQt6.QtGui import QPainter, QColor

class Toolbar(QWidget):
    def __init__(
        self,
        parent: QWidget | None = None,
        flags: Qt.WindowType = Qt.WindowType.Widget,
    ) -> None:
        super().__init__(parent, flags)
        self.setMinimumHeight(50)

    def paintEvent(self, event) -> None:
        painter = QPainter(self)
        # 绘制浅灰色背景
        painter.fillRect(self.rect(), QColor("#f0f0f0"))
        # 可添加其他自定义绘制逻辑，比如分隔线、图标等
        super().paintEvent(event)

补充说明 #

• 你尝试的setVisible(True)和调整SizePolicy无效，是因为控件本身已经处于可见状态，布局也正确计算了它的尺寸，只是没有可视化内容让你感知到它的存在。
• 后续若要给工具栏添加按钮等交互控件，只需在Toolbar的初始化方法中添加子控件并设置内部布局即可，此时控件会因子控件的存在自动呈现。

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