如何从PySide2的QML获取根对象并实现窗口最小化到系统托盘

我来帮你搞定这个问题！在Python的PyQt/PySide环境下，要获取QML里的ApplicationWindow根对象，再实现最小化到系统托盘的功能其实并不复杂，我给你一步步拆解，还附上完整的可运行示例：

1. 正确获取QML根对象 #

和C++里的engine.rootObjects().at(0)对应，Python里直接用engine.rootObjects()[0]就能拿到QML的根对象——也就是你定义的ApplicationWindow实例。这个对象在Python里是QObject子类，我们可以把它转换成QWindow（准确说是QQuickWindow，继承自QWindow）来操作窗口的显示/隐藏。

示例代码：

from PySide6.QtQml import QQmlApplicationEngine
from PySide6.QtCore import qobject_cast
from PySide6.QtGui import QWindow

engine = QQmlApplicationEngine()
engine.load("main.qml")
# 获取根对象
root_obj = engine.rootObjects()[0]
# 转换成QWindow类型，方便操作窗口
main_window = qobject_cast(QWindow, root_obj)

你之前改成QMainWindow后操作的是新窗口，是因为那是你在Python里手动创建的独立窗口，和QML渲染的ApplicationWindow完全不是同一个对象，所以现在这个方法才是直接操作原有应用窗口的正确方式。

2. 实现系统托盘逻辑 #

接下来创建QSystemTrayIcon，设置图标、右键菜单，再连接信号处理托盘点击和菜单操作：

from PySide6.QtWidgets import QSystemTrayIcon, QMenu, QAction
from PySide6.QtGui import QIcon

# 创建托盘图标
tray_icon = QSystemTrayIcon(QIcon("tray_icon.png"))
tray_icon.setToolTip("我的迷你应用")

# 右键菜单
menu = QMenu()
restore_action = QAction("恢复窗口")
quit_action = QAction("退出")
menu.addAction(restore_action)
menu.addAction(quit_action)
tray_icon.setContextMenu(menu)

# 信号槽连接
def on_tray_activated(reason):
    if reason == QSystemTrayIcon.DoubleClick:
        main_window.show()
        tray_icon.hide()

def restore_window():
    main_window.show()
    tray_icon.hide()

def quit_app():
    main_window.close()
    tray_icon.hide()
    QCoreApplication.instance().quit()

tray_icon.activated.connect(on_tray_activated)
restore_action.triggered.connect(restore_window)
quit_action.triggered.connect(quit_app)

3. 连接QML与Python的最小化逻辑 #

在QML里添加一个按钮，点击后调用Python的方法隐藏窗口并显示托盘：

ApplicationWindow {
    id: mainWindow
    visible: true
    width: 640
    height: 480
    title: qsTr("迷你应用")

    Button {
        anchors.centerIn: parent
        text: "最小化到托盘"
        onClicked: backend.minimizeToTray()
    }
}

然后在Python里写一个后端类（继承QObject），把方法暴露给QML：

from PySide6.QtCore import QObject, Slot

class Backend(QObject):
    def __init__(self, main_window, tray_icon):
        super().__init__()
        self.main_window = main_window
        self.tray_icon = tray_icon

    @Slot()
    def minimizeToTray(self):
        self.main_window.hide()
        self.tray_icon.show()

记得把后端注册到QML上下文：

backend = Backend(main_window, tray_icon)
engine.rootContext().setContextProperty("backend", backend)

4. 关键配置：阻止窗口关闭时退出应用 #

一定要加上这句代码，否则当窗口隐藏后，应用会因为没有可见窗口自动退出：

app.setQuitOnLastWindowClosed(False)

Python部分（main.py） #

import sys
from PySide6.QtCore import QObject, Slot, qobject_cast, QCoreApplication
from PySide6.QtGui import QWindow, QIcon
from PySide6.QtQml import QQmlApplicationEngine
from PySide6.QtWidgets import QSystemTrayIcon, QMenu, QAction

class Backend(QObject):
    def __init__(self, main_window, tray_icon):
        super().__init__()
        self.main_window = main_window
        self.tray_icon = tray_icon

    @Slot()
    def minimizeToTray(self):
        self.main_window.hide()
        self.tray_icon.show()

if __name__ == "__main__":
    app = QCoreApplication(sys.argv)
    # 核心配置：窗口隐藏时不退出应用
    app.setQuitOnLastWindowClosed(False)

    engine = QQmlApplicationEngine()
    engine.load("main.qml")
    if not engine.rootObjects():
        sys.exit(-1)

    # 获取QML根窗口
    root_obj = engine.rootObjects()[0]
    main_window = qobject_cast(QWindow, root_obj)

    # 初始化系统托盘
    tray_icon = QSystemTrayIcon(QIcon("tray_icon.png"))
    tray_icon.setToolTip("我的迷你应用")

    # 托盘右键菜单
    menu = QMenu()
    restore_action = QAction("恢复窗口")
    quit_action = QAction("退出")
    menu.addAction(restore_action)
    menu.addAction(quit_action)
    tray_icon.setContextMenu(menu)

    # 信号绑定
    def on_tray_activated(reason):
        if reason == QSystemTrayIcon.DoubleClick:
            main_window.show()
            tray_icon.hide()

    def restore_window():
        main_window.show()
        tray_icon.hide()

    def quit_app():
        main_window.close()
        tray_icon.hide()
        app.quit()

    tray_icon.activated.connect(on_tray_activated)
    restore_action.triggered.connect(restore_window)
    quit_action.triggered.connect(quit_app)

    # 注册后端到QML
    backend = Backend(main_window, tray_icon)
    engine.rootContext().setContextProperty("backend", backend)

    sys.exit(app.exec())

QML部分（main.qml） #

import QtQuick 2.15
import QtQuick.Window 2.15
import QtQuick.Controls 2.15

ApplicationWindow {
    id: mainWindow
    visible: true
    width: 640
    height: 480
    title: qsTr("迷你应用")

    Button {
        anchors.centerIn: parent
        text: "最小化到托盘"
        onClicked: backend.minimizeToTray()
    }

    // 可选：拦截关闭按钮，直接最小化到托盘
    onClosing: {
        backend.minimizeToTray()
        close.accepted = false
    }
}

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