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

苏锦广 發表於 2025-9-14 11:57:00

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

在 PySide6 / PyQt6 或其他 GUI 程序中，启动画面主要有以下几个作用：提升用户体验，当主程序初始化需要几秒钟时，如果界面一直空白，用户可能以为程序没响应；品牌展示，常见做法是在启动画面上放置公司 Logo、应用图标、版本号、版权信息；程序架构上的过渡，启动画面在主窗口创建前显示，等主程序准备就绪后再关闭，起到过渡和占位的作用。
<h3>1、简单例子代码介绍</h3>
在 PySide6 / PyQt6 里要实现启动画面（Splash Screen），通常可以用 QSplashScreen 来完成，和 wx.adv.SplashScreen 类似。它的主要作用是在主窗口加载前，先显示一个过渡画面（通常放 logo、版本号、加载提示）。
简单的案例代码如下所示。
<div class="cnblogs_code">
<pre>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()</pre>
</div>
关键点：
<ol data-start="1375" data-end="1665">
<li data-start="1375" data-end="1540">
QSplashScreen
<ul data-start="1401" data-end="1540">
<li data-start="1401" data-end="1436">
通过 <code data-start="1406" data-end="1430">QSplashScreen(QPixmap)</code> 创建。
</li>
<li data-start="1440" data-end="1491">
<code data-start="1442" data-end="1479">showMessage(text, alignment, color)</code> 用来显示提示信息。
</li>
<li data-start="1495" data-end="1540">
<code data-start="1497" data-end="1513">finish(widget)</code> 在主窗口准备好后关闭 Splash，并显示目标窗口。
</li>
</ul>
</li>
<li data-start="1542" data-end="1606">
app.processEvents()
<ul data-start="1574" data-end="1606">
<li data-start="1574" data-end="1606">
在耗时操作中调用，确保 Splash 画面能刷新，不会卡死。
</li>
</ul>
</li>
<li data-start="1608" data-end="1665">
QTimer.singleShot()
<ul data-start="1640" data-end="1665">
<li data-start="1640" data-end="1665">
可以避免界面卡顿，等初始化完成后关闭启动画面。
</li>
</ul>
</li>
</ol>
<h3>2、我使用PySide6/PyQt6实现程序启动画面</h3>
参照上面的过程，我们可以改进下程序启动画面，并结合程序初始化等过程进行展示。
我们在程序登录界面展示，用户确认登录成功后，提示启动画面的。
<img src="https://img2024.cnblogs.com/blog/8867/202509/8867-20250914113811255-1479232313.png" alt="image" loading="lazy">
 用户登录成功后，闪屏启动页面进行展示
<img src="https://img2024.cnblogs.com/blog/8867/202509/8867-20250914113908541-1030003181.png" alt="image" width="598" height="317" loading="lazy">
 实现过程也是和上面的例子类似，不过增加了一些特殊的处理。
首先封装好显示闪屏界面的函数，如下所示。
<div class="cnblogs_code">
<pre>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</pre>
</div>
然后再启动的main.py的main函数中处理各个操作过程即可。
<div class="cnblogs_code">
<pre>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()</pre>
</div>
我们的主程序使用了异步的操作，因此和上面的例子有所差异，在用户登录成功后，前端会获得相关的用户身份信息，并在 init_app() 函数中进行用户身份信息的获取和设置。
我们把用户身份信息的处理，单独抽取出来，放在system_app类里面进行处理，如下所示，可以根据登录用户的信息，获取用户的当前拥有的功能权限，角色集合等等。
<img src="https://img2024.cnblogs.com/blog/8867/202509/8867-20250914114849017-1264603685.png" alt="image" width="951" height="1227" loading="lazy">
前面随笔我介绍过， 对于列表和对话框界面的封装，能够简化对泛型模型数据的统一处理，通用对于前端用户身份信息，我们也可以集中在基类中获取。
<img src="https://img2024.cnblogs.com/blog/8867/202502/8867-20250226144241472-1488282641.png" alt="" class="medium-zoom-image" loading="lazy">
<img src="https://img2024.cnblogs.com/blog/8867/202509/8867-20250914115427349-1192132373.png" alt="image" width="797" height="438" loading="lazy">
 编辑对话框的基类同样的处理。
<img src="https://img2024.cnblogs.com/blog/8867/202509/8867-20250914115546823-1829558458.png" alt="image" width="795" height="751" loading="lazy">
 这样我们在用户前端界面中，需要设置用户当前信息的时候，就可以随时通过基类函数进行获取了。
上面代码，结合闪屏启动界面的处理过程，介绍了在用户登录成功后，对用户相关信息的处理过程。

</div>
<div id="MySignature" role="contentinfo">
<div style="border-right-color: #cccccc; border-right-width: 1px; border-right-style: solid; padding-right: 5px; border-top-color: #cccccc; border-top-width: 1px; border-top-style: solid; padding-left: 4px; font-size: 13px; padding-bottom: 4px; border-left-color: #cccccc; border-left-width: 1px; border-left-style: solid; width: 98%; padding-top: 4px; border-bottom-color: #cccccc; border-bottom-width: 1px; border-bottom-style: solid; background-color: #eeeeee;">
<img src="http://www.cnblogs.com/Images/OutliningIndicators/None.gif" align="top" alt>

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

頁: [1]

琼殿技术论坛's Archiver

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