PyQt自定义标题栏与可停靠工具栏适配问题

问题根源 #

核心问题在于QMainWindow的可停靠区域默认围绕中央部件（central widget），如果把自定义标题栏放在central widget内部，工具栏会将标题栏视为central widget的一部分，从而出现停靠在标题栏上方或挤压标题栏的情况。要解决这个问题，需让自定义标题栏脱离central widget，作为QMainWindow的独立子部件，同时让central widget位于标题栏下方，确保停靠区域只围绕central widget。

修改方案及代码 #

修正后的完整代码 #

import sys
from PyQt5.QtWidgets import (QApplication, QMainWindow, QWidget, QVBoxLayout, QToolBar, QPushButton)
from PyQt5.QtCore import Qt, QRect

class CustomTitleBar(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setStyleSheet("background-color: #333; color: white;")
        layout = QVBoxLayout(self)
        close_btn = QPushButton("Close")
        close_btn.clicked.connect(parent.close)
        layout.addWidget(close_btn)
        self.setFixedHeight(30)

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowFlags(Qt.FramelessWindowHint)
        # 将标题栏设为主窗口的直接子部件，而非放入central widget
        self.title_bar = CustomTitleBar(self)
        
        # 创建central widget承载实际业务内容
        central_widget = QWidget()
        self.setCentralWidget(central_widget)
        central_layout = QVBoxLayout(central_widget)
        # 示例内容部件
        content = QWidget()
        content.setStyleSheet("background-color: white;")
        central_layout.addWidget(content)
        
        # 添加可停靠工具栏
        toolbar = QToolBar("Toolbar")
        toolbar.addAction("Action 1")
        toolbar.addAction("Action 2")
        self.addToolBar(toolbar)
        
        # 初始化部件位置
        self._adjust_widgets()

    def resizeEvent(self, event):
        super().resizeEvent(event)
        # 窗口大小变化时重新调整部件位置
        self._adjust_widgets()

    def _adjust_widgets(self):
        # 标题栏铺满窗口顶部
        self.title_bar.setGeometry(QRect(0, 0, self.width(), self.title_bar.height()))
        # 中央部件位于标题栏下方，占据剩余窗口空间
        central_rect = QRect(0, self.title_bar.height(), self.width(), self.height() - self.title_bar.height())
        self.centralWidget().setGeometry(central_rect)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.resize(800, 600)
    window.show()
    sys.exit(app.exec_())

关键修改点 #

• 标题栏独立化：将自定义标题栏直接作为QMainWindow的子部件，不再放入central widget内，避免被停靠区域包含。
• 动态布局调整：重写resizeEvent方法，确保窗口大小变化时，标题栏始终铺满窗口顶部，central widget始终位于标题栏下方，占据剩余空间。
• 保留原生停靠逻辑：QMainWindow的可停靠工具栏默认围绕central widget，现在central widget在标题栏下方，工具栏只会在central widget的四周停靠，不会影响标题栏。

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