PySide6中结合QUiLoader使用QMetaObject.connectSlotsByName的方法

原始可运行代码 #

Python代码 #

from os import path

from PySide6.QtCore import QObject, QMetaObject
from PySide6.QtUiTools import QUiLoader
from PySide6.QtWidgets import QApplication


class MyWin(QObject):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.ui = QUiLoader().load(path.join(path.dirname(__file__), "MainWindow.ui"))
        self.ui.pushButton.clicked.connect(self.on_pushButton_clicked)

    def show(self):
        self.ui.show()

    def on_pushButton_clicked(self):
        print("button pushed!")


app = QApplication([])
win = MyWin()
win.show()
app.exec()

MainWindow.ui内容 #

<?xml version="1.0" encoding="UTF-8"?>
<ui version="4.0">
 <class>MainWindow</class>
 <widget class="QMainWindow" name="MainWindow">
  <property name="geometry">
   <rect>
    <x>0</x>
    <y>0</y>
    <width>800</width>
    <height>600</height>
   </rect>
  </property>
  <property name="windowTitle">
   <string>MainWindow</string>
  </property>
  <widget class="QWidget" name="centralwidget">
   <layout class="QVBoxLayout" name="verticalLayout">
    <item>
     <widget class="QPushButton" name="pushButton">
      <property name="text">
       <string>PushButton</string>
      </property>
     </widget>
    </item>
    <item>
     <widget class="QTableView" name="tableView"/>
    </item>
   </layout>
  </widget>
  <widget class="QMenuBar" name="menubar">
   <property name="geometry">
    <rect>
     <x>0</x>
     <y>0</y>
     <width>800</width>
     <height>19</height>
    </rect>
   </property>
  </widget>
  <widget class="QStatusBar" name="statusbar"/>
 </widget>
 <resources/>
 <connections/>
</ui>

核心疑问 #

如何用QMetaObject.connectSlotsByName(???)替代手动连接代码self.ui.pushButton.clicked.connect(self.on_pushButton_clicked)？

PySide6的QUiLoader无法像PyQt6的uic.loadUi(filename, self)那样将部件直接作为self的子对象，只能把UI存入单独变量self.ui，但槽函数定义在MyWin类中，该怎么突破这个限制？实际项目中信号槽数量多，手动连接不仅繁琐还容易出错，因此需要自动连接方案。

更新1：尝试继承QWidget后的问题 #

将MyWin改为继承QWidget，设置self.ui.setParent(self)后，UI无法显示，还出现以下错误：

mcon@ikea:~/projects/pyside6-test$ venv/bin/python t.py
qt.pysideplugin: Environment variable PYSIDE_DESIGNER_PLUGINS is not set, bailing out.
qt.pysideplugin: No instance of QPyDesignerCustomWidgetCollection was found.
Qt WebEngine seems to be initialized from a plugin. Please set Qt::AA_ShareOpenGLContexts using QCoreApplication::setAttribute and QSGRendererInterface::OpenGLRhi using QQuickWindow::setGraphicsApi before constructing QGuiApplication.
^C^C^C^C
Terminated

正常Ctrl-C无法终止进程，必须从其他终端杀死。

更新2：自定义UiLoader后槽函数不触发 #

按照建议自定义了UiLoader类，GUI能正常显示，但按钮点击无法触发槽函数，只有手动连接才有效。代码如下：

from os import path

from PySide6.QtCore import QMetaObject
from PySide6.QtUiTools import QUiLoader
from PySide6.QtWidgets import QApplication, QWidget, QMainWindow


class UiLoader(QUiLoader):
    _baseinstance = None

    def createWidget(self, classname, parent=None, name=''):
        if parent is None and self._baseinstance is not None:
            widget = self._baseinstance
        else:
            widget = super(UiLoader, self).createWidget(classname, parent, name)
            if self._baseinstance is not None:
                setattr(self._baseinstance, name, widget)
        return widget

    def loadUi(self, uifile, baseinstance=None):
        self._baseinstance = baseinstance
        widget = self.load(uifile)
        QMetaObject.connectSlotsByName(widget)
        return widget


class MyWin(QMainWindow):
    def __init__(self, parent=None):
        super().__init__(parent)
        UiLoader().loadUi(path.join(path.dirname(__file__), "MainWindow.ui"), self)
        # self.pushButton.clicked.connect(self.on_pushButton_clicked)
        QMetaObject.connectSlotsByName(self)

    def on_pushButton_clicked(self):
        print("button pushed!")


app = QApplication([])
win = MyWin()
win.show()
app.exec()

你的自定义UiLoader存在两个关键问题，导致自动连接失效：

1. 主窗口部件赋值错误：
   在createWidget方法中，当parent is None时直接返回self._baseinstance，但你的UI文件根部件是QMainWindow，而MyWin本身就是QMainWindow子类，这会导致UI加载过程中部件层级混乱，信号槽无法正确关联。

2. connectSlotsByName调用对象错误：
   自动连接需要在槽函数所在的对象上调用，并且确保所有子部件的objectName能被正确识别。

修改方案1：修复自定义UiLoader #

from os import path

from PySide6.QtCore import QMetaObject
from PySide6.QtUiTools import QUiLoader
from PySide6.QtWidgets import QApplication, QMainWindow


class UiLoader(QUiLoader):
    def __init__(self, baseinstance):
        super().__init__(baseinstance)
        self.baseinstance = baseinstance

    def createWidget(self, classname, parent=None, name=''):
        # 仅对非顶层部件进行属性赋值
        widget = super().createWidget(classname, parent, name)
        if parent is not None and self.baseinstance is not None:
            setattr(self.baseinstance, name, widget)
        return widget

    def load(self, uifile):
        widget = super().load(uifile)
        if self.baseinstance is not None:
            # 将UI的核心部件挂载到当前QMainWindow实例
            self.baseinstance.setCentralWidget(widget.centralWidget())
            self.baseinstance.setMenuBar(widget.menuBar())
            self.baseinstance.setStatusBar(widget.statusBar())
            self.baseinstance.setWindowTitle(widget.windowTitle())
        # 在槽函数所在的实例上调用自动连接
        QMetaObject.connectSlotsByName(self.baseinstance)
        return widget


class MyWin(QMainWindow):
    def __init__(self, parent=None):
        super().__init__(parent)
        loader = UiLoader(self)
        loader.load(path.join(path.dirname(__file__), "MainWindow.ui"))

    def on_pushButton_clicked(self):
        print("button pushed!")


app = QApplication([])
win = MyWin()
win.show()
app.exec()

修改方案2：直接映射部件引用 #

更简洁的方式，直接将UI的子部件映射到MyWin实例后调用自动连接：

from os import path
from PySide6.QtCore import QMetaObject, QObject
from PySide6.QtUiTools import QUiLoader
from PySide6.QtWidgets import QApplication, QMainWindow


class MyWin(QMainWindow):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.ui = QUiLoader().load(path.join(path.dirname(__file__), "MainWindow.ui"))
        # 将UI的所有子部件映射到当前实例
        for name in dir(self.ui):
            attr = getattr(self.ui, name)
            if isinstance(attr, QObject):
                setattr(self, name, attr)
        # 同步UI的窗口属性到当前实例
        self.setCentralWidget(self.ui.centralWidget())
        self.setMenuBar(self.ui.menuBar())
        self.setStatusBar(self.ui.statusBar())
        self.setWindowTitle(self.ui.windowTitle())
        # 在当前实例上触发自动连接
        QMetaObject.connectSlotsByName(self)

    def on_pushButton_clicked(self):
        print("button pushed!")


app = QApplication([])
win = MyWin()
win.show()
app.exec()

关键说明 #

• 自动连接的核心要求：槽函数所在的对象必须能通过objectName找到对应的部件，因此需要把UI中的部件引用挂载到槽函数所在的MyWin实例上。
• 对于QMainWindow子类，不能直接把加载的UI窗口设为父对象，而是要将其centralWidget、menuBar、statusBar等核心部件挂载到当前MyWin实例，避免层级混乱。
• QMetaObject.connectSlotsByName必须在槽函数所在的实例上调用，这样Qt才能遍历该实例的槽函数，匹配对应部件的信号。

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