使用PySide6/PyQt6实现程序启动画面的处理

最新推荐文章于 2025-12-12 21:46:19 发布

转载最新推荐文章于 2025-12-12 21:46:19 发布 · 58 阅读

0 ·

CC 4.0 BY-SA版权

原文链接：https://yours.tools/zh/htmloutjs.html

文章标签：

#it

在 PySide6 / PyQt6 或其他 GUI 程序中，启动画面主要有以下几个作用：提升用户体验，当主程序初始化需要几秒钟时，如果界面一直空白，用户可能以为程序没响应；品牌展示，常见做法是在启动画面上放置公司 Logo、应用图标、版本号、版权信息；程序架构上的过渡，启动画面在主窗口创建前显示，等主程序准备就绪后再关闭，起到过渡和占位的作用。

1、简单例子代码介绍

在 PySide6 / PyQt6 里要实现启动画面（Splash Screen），通常可以用 QSplashScreen 来完成，和 wx.adv.SplashScreen 类似。它的主要作用是在主窗口加载前，先显示一个过渡画面（通常放 logo、版本号、加载提示）。

简单的案例代码如下所示。

def main():
    app = QApplication(sys.argv)

    # 创建启动画面
    pixmap = QPixmap(400, 300)  # 可以替换为 QPixmap("logo.png")
    pixmap.fill(Qt.white)  # 这里用纯白背景
    splash = QSplashScreen(pixmap)
    splash.showMessage("正在加载，请稍候...", Qt.AlignBottom | Qt.AlignCenter, Qt.black)
    splash.show()

    # 模拟加载过程（比如初始化数据库、加载配置等）
    for i in range(1, 6):
        splash.showMessage(f"正在加载资源 {i}/5 ...", Qt.AlignBottom | Qt.AlignCenter, Qt.black)
        app.processEvents()  # 让界面刷新
        time.sleep(0.5)

    # 加载完成后进入主窗口
    window = MainWindow()

    # 延迟关闭启动画面并显示主窗口
    QTimer.singleShot(500, lambda: (
        splash.finish(window),
        window.show()
    ))

    sys.exit(app.exec())


if __name__ == "__main__":
    main()

关键点：

QSplashScreen
- 通过 QSplashScreen(QPixmap) 创建。
- showMessage(text, alignment, color) 用来显示提示信息。
- finish(widget) 在主窗口准备好后关闭 Splash，并显示目标窗口。
app.processEvents()
- 在耗时操作中调用，确保 Splash 画面能刷新，不会卡死。
QTimer.singleShot()
- 可以避免界面卡顿，等初始化完成后关闭启动画面。

2、我使用PySide6/PyQt6实现程序启动画面

参照上面的过程，我们可以改进下程序启动画面，并结合程序初始化等过程进行展示。

我们在程序登录界面展示，用户确认登录成功后，提示启动画面的。

用户登录成功后，闪屏启动页面进行展示

实现过程也是和上面的例子类似，不过增加了一些特殊的处理。

首先封装好显示闪屏界面的函数，如下所示。

def show_splash_screen():
    """显示启动闪屏"""
    splash_pix = QPixmap("app/images/splash.png")
    splash = QSplashScreen(splash_pix, Qt.WindowType.WindowStaysOnTopHint)

    # 设置字体
    font = QFont("Arial", 20, QFont.Weight.Bold)
    splash.setFont(font)
    splash.showMessage(
        "正在加载，请稍候...",
        Qt.AlignmentFlag.AlignBottom | Qt.AlignmentFlag.AlignCenter,
        Qt.GlobalColor.yellow,
    )
    splash.show()
    return splash

然后再启动的main.py的main函数中处理各个操作过程即可。

async def init_app():
    app = SystemApp()
    await app.SetLoginInfo()

def main():
    app = QApplication(sys.argv)

    event_loop = QEventLoop(app)
    asyncio.set_event_loop(event_loop)

    app_close_event = asyncio.Event()
    app.aboutToQuit.connect(app_close_event.set)

    app.setStyle("Fusion")  # 设置样式# 显示登录窗口
    loginDialog = FrmLogin()
    if loginDialog.exec() != QDialog.DialogCode.Accepted:
        # 如果登录失败或取消，程序退出
        sys.exit(0)

    # 显示闪屏
    splash = show_splash_screen()
    # 主窗口
    main_window = MainWindow()
    # 设置托盘图标
    setup_tray_icon(app, main_window)
    # 闪屏后显示主界面, 1秒后窗口最大化显示
    QTimer.singleShot(1000, lambda: (splash.close(), main_window.showMaximized()))

    # sys.exit(app.exec())

    with event_loop:
        event_loop.create_task(init_app())
        event_loop.run_until_complete(app_close_event.wait())

if __name__ == "__main__":
    main()

我们的主程序使用了异步的操作，因此和上面的例子有所差异，在用户登录成功后，前端会获得相关的用户身份信息，并在 init_app() 函数中进行用户身份信息的获取和设置。

我们把用户身份信息的处理，单独抽取出来，放在system_app类里面进行处理，如下所示，可以根据登录用户的信息，获取用户的当前拥有的功能权限，角色集合等等。

前面随笔我介绍过，对于列表和对话框界面的封装，能够简化对泛型模型数据的统一处理，通用对于前端用户身份信息，我们也可以集中在基类中获取。

编辑对话框的基类同样的处理。

这样我们在用户前端界面中，需要设置用户当前信息的时候，就可以随时通过基类函数进行获取了。

上面代码，结合闪屏启动界面的处理过程，介绍了在用户登录成功后，对用户相关信息的处理过程。

专注于代码生成工具、.Net/Python 框架架构及软件开发，以及各种Vue.js的前端技术应用。著有Winform开发框架/混合式开发框架、微信开发框架、Bootstrap开发框架、ABP开发框架、SqlSugar开发框架、Python开发框架等框架产品。
转载请注明出处：撰写人：伍华聪 http://www.iqidi.com