PyQt5拖拽自定义QFrame标题栏报错：MainWindow.move()参数不符

在PyQt5中用自定义QFrame做窗口标题栏，实现拖拽移动功能时，控制台报错：MainWindow.move() takes 1 positional argument but 2 were given，程序直接崩溃。尝试给moveWindow()加self参数时，又提示event未传入。

错误代码核心问题 #

1. 事件绑定上下文混乱：直接将borderFrame.mouseMoveEvent赋值为内部函数moveWindow，导致函数调用时self指向错误，触发move方法的参数传递异常。
2. 鼠标按下事件未生效：在__init__内定义的mousePressEvent是内部函数，并未真正重写MainWindow的鼠标按下事件，dragPos变量无法正确初始化。

修正后的代码 #

MainWindow类代码 #

from PyQt5.QtWidgets import QApplication, QMainWindow, QtWidgets
from PyQt5.QtCore import Qt, QPoint
from PyQt5 import uic
from untitled import Ui_MainWindow

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        
        # 窗口基础配置
        self.setWindowTitle("Project")
        self.setWindowFlags(Qt.FramelessWindowHint)
        self.setAttribute(Qt.WA_TranslucentBackground)
        uic.loadUi("src/ui/untitle.ui", self)
        self.ui = Ui_MainWindow()
        self.ui.setupUi(self)
        
        self.borderFrame.setFrameShape(QtWidgets.QFrame.StyledPanel)
        self.borderFrame.setFrameShadow(QtWidgets.QFrame.Raised)
        self.borderFrame.setObjectName("borderFrame")
        
        # 给标题栏框架安装事件过滤器
        self.ui.borderFrame.installEventFilter(self)

    # 重写鼠标按下事件，保存拖拽起始点
    def mousePressEvent(self, event):
        if event.button() == Qt.LeftButton:
            self.dragPos = event.globalPos()
            event.accept()

    # 事件过滤器处理标题栏的鼠标移动事件
    def eventFilter(self, obj, event):
        if obj == self.ui.borderFrame:
            if event.type() == event.MouseMove:
                if event.buttons() == Qt.LeftButton:
                    # 计算窗口新位置
                    pos = self.pos() + event.globalPos() - self.dragPos
                    self.move(pos)
                    self.dragPos = event.globalPos()
                    event.accept()
        return super().eventFilter(obj, event)

if __name__ == "__main__":
    import sys
    app = QtWidgets.QApplication(sys.argv)
    window = MainWindow()
    window.show()  # 补充原代码遗漏的窗口显示逻辑
    sys.exit(app.exec_())

Ui_MainWindow代码（修正语法错误） #

from PyQt5.QtWidgets import QtWidgets
from PyQt5 import QtCore

class Ui_MainWindow(object):
    def setupUi(self, Window):
        Window.setObjectName("Window")
        Window.resize(1241, 700)  # 补充必要的窗口初始化参数
        self.centralwidget = QtWidgets.QWidget(Window)
        self.centralwidget.setObjectName("centralwidget")
        # --- Border frame QFrame
        self.borderFrame = QtWidgets.QFrame(self.centralwidget)
        self.borderFrame.setGeometry(QtCore.QRect(-10, 0, 1261, 36))
        # 修正样式表引号未闭合的语法错误
        self.borderFrame.setStyleSheet("background-color: rgba(0, 0, 0, 0.65);")
        Window.setCentralWidget(self.centralwidget)

关键修正说明 #

1. 改用事件过滤器处理事件：通过installEventFilter监听标题栏的鼠标移动事件，保证函数调用上下文正确，避免参数传递混乱。
2. 正确重写鼠标按下事件：将mousePressEvent定义为类方法，确保dragPos能正确保存鼠标按下时的全局坐标。
3. 修复样式表语法错误：原代码中样式表引号未闭合，补充后保证背景样式生效。
4. 补充窗口显示逻辑：添加window.show()确保窗口正常显示。

内容的提问来源于stack exchange，提问作者goose.mp4