3分钟切换暗黑/亮色模式！PyQtDarkTheme主题切换与OS系统同步技巧

【免费下载链接】PyQtDarkThemeA flat dark theme for PySide and PyQt.项目地址: https://gitcode.com/gh_mirrors/py/PyQtDarkTheme

PyQtDarkTheme是一款专为PySide和PyQt打造的扁平化暗黑主题工具，让开发者能够轻松实现应用程序的主题切换功能，包括与操作系统主题自动同步的高级特性。本文将详细介绍如何在3分钟内完成主题切换设置，以及实现与系统主题同步的实用技巧。

🌟 主题效果展示

PyQtDarkTheme提供了两种主要主题模式，满足不同场景下的使用需求：

暗黑模式展示

图1：PyQtDarkTheme暗黑模式下的各种控件展示，包括按钮、复选框、滑块等界面元素

亮色模式展示

图2：PyQtDarkTheme亮色模式下的控件展示，与暗黑模式形成鲜明对比

🔄 基础主题切换方法

实现主题切换非常简单，只需使用qdarktheme.setup_theme()函数即可快速应用不同主题。

一键切换主题

最基础的主题切换可以通过以下方式实现：

• 应用暗黑主题：qdarktheme.setup_theme("dark")
• 应用亮色主题：qdarktheme.setup_theme("light")

在实际应用中，可以通过下拉框控件实现动态切换，如examples/toggle_theme/toggle_dark_light.py中的实现方式：

combo_box.currentTextChanged.connect(qdarktheme.setup_theme)

🖥️ 与操作系统主题同步

PyQtDarkTheme最强大的功能之一是能够与操作系统主题自动同步，实现应用主题随系统设置变化而自动切换。

自动同步系统主题

图3：PyQtDarkTheme应用随系统主题设置自动切换暗黑/亮色模式的演示效果

要实现与系统主题同步，只需在设置主题时使用"auto"参数：

qdarktheme.setup_theme("auto")

这段代码会自动检测系统当前的主题设置，并应用相应的暗黑或亮色主题，如examples/toggle_theme/sync_with_os_theme.py所示。

⚙️ 高级主题定制

除了基础的主题切换，PyQtDarkTheme还支持多种高级定制选项，让你的应用界面更加个性化。

自定义主题颜色

你可以通过custom_colors参数自定义主题的颜色：

qdarktheme.setup_theme(custom_colors={"primary": "#D0BCFF"})

调整边角形状

通过corner_shape参数可以调整控件的边角形状：

qdarktheme.setup_theme(corner_shape="sharp")

附加样式表

如果需要进一步自定义样式，可以通过additional_qss参数添加额外的样式表：

qdarktheme.setup_theme(additional_qss=your_custom_qss)

🚀 快速开始使用

要开始使用PyQtDarkTheme，首先需要克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/py/PyQtDarkTheme

然后在你的PyQt/PySide应用中导入并使用：

import qdarktheme from PyQt6.QtWidgets import QApplication app = QApplication([]) qdarktheme.setup_theme("auto") # 自动同步系统主题 # 或者手动指定主题 # qdarktheme.setup_theme("dark") # qdarktheme.setup_theme("light") # 你的应用代码... app.exec()

📚 更多资源

• 官方文档：docs/
• 示例代码：examples/
• 主题切换示例：examples/toggle_theme/

通过PyQtDarkTheme，你可以在几分钟内为你的PyQt/PySide应用添加专业的主题切换功能，提升用户体验。无论是手动切换还是与系统主题同步，PyQtDarkTheme都能满足你的需求，让应用界面更加现代化和个性化。

【免费下载链接】PyQtDarkThemeA flat dark theme for PySide and PyQt.项目地址: https://gitcode.com/gh_mirrors/py/PyQtDarkTheme