PyQt5自定义标题栏拖动窗口功能实现求助

你遇到的问题核心是：自定义标题栏作为子控件，鼠标事件仅作用于自身，没有关联到主窗口的位置更新。下面是直接可用的解决方案，以及关键逻辑说明：

核心实现逻辑 #

通过重写自定义标题栏的鼠标事件，记录鼠标按下时的初始偏移量，在鼠标移动时计算主窗口的新位置并更新。

自定义标题栏代码 #

from PyQt5.QtWidgets import QWidget, QHBoxLayout, QPushButton
from PyQt5.QtCore import Qt, QPoint

class CustomTitleBar(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setStyleSheet("background-color: blue; height: 30px;")
        self.layout = QHBoxLayout(self)
        self.layout.setContentsMargins(5, 0, 5, 0)
        
        # 示例按钮（可替换成你的控件）
        self.close_btn = QPushButton("×")
        self.close_btn.setStyleSheet("color: white; border: none;")
        self.close_btn.clicked.connect(parent.close)
        
        self.layout.addStretch()
        self.layout.addWidget(self.close_btn)
        
        # 记录位置变量
        self._mouse_start_pos = QPoint()
        self._window_start_pos = QPoint()

    def mousePressEvent(self, event):
        if event.button() == Qt.LeftButton:
            # 记录鼠标相对于标题栏的局部位置
            self._mouse_start_pos = event.pos()
            # 记录主窗口当前的全局位置
            self._window_start_pos = self.parent().frameGeometry().topLeft()
            event.accept()

    def mouseMoveEvent(self, event):
        if event.buttons() & Qt.LeftButton:
            # 计算鼠标移动的偏移量
            offset = event.pos() - self._mouse_start_pos
            # 更新主窗口位置
            self.parent().move(self._window_start_pos + offset)
            event.accept()

主窗口集成代码 #

from PyQt5.QtWidgets import QMainWindow, QWidget, QVBoxLayout

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        # 必须设置无框窗口，否则默认标题栏会干扰拖动逻辑
        self.setWindowFlags(Qt.FramelessWindowHint)
        
        central_widget = QWidget()
        self.setCentralWidget(central_widget)
        main_layout = QVBoxLayout(central_widget)
        main_layout.setContentsMargins(0, 0, 0, 0)
        main_layout.setSpacing(0)
        
        # 替换成你代码中的self.frame_WINDOW_HINT
        self.frame_WINDOW_HINT = CustomTitleBar(self)
        main_layout.addWidget(self.frame_WINDOW_HINT)
        
        # 示例内容区域
        content_widget = QWidget()
        content_widget.setStyleSheet("background-color: #f0f0f0; min-height: 350px;")
        main_layout.addWidget(content_widget)
        
        self.resize(400, 400)

关键注意事项 #

• 必须给主窗口设置Qt.FramelessWindowHint：这是自定义标题栏的前提，否则默认标题栏会抢占鼠标事件，且窗口移动逻辑会冲突。
• 记录正确的位置偏移：不能直接用鼠标的全局位置计算，必须记录鼠标相对于标题栏的局部位置和窗口初始全局位置，否则拖动时窗口会出现跳变。
• 处理子控件事件冲突：如果标题栏内有按钮等可交互控件，确保这些控件的鼠标事件不会覆盖标题栏的拖动事件（上面的代码中按钮点击不会影响，因为只有左键按下标题栏空白区域才会触发拖动）。

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