PyQt-Fluent-Widgets主题系统深度解析

最新推荐文章于 2025-06-06 09:11:27 发布

巫清焘

最新推荐文章于 2025-06-06 09:11:27 发布

阅读量330

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00372/article/details/148465824

PyQt-Fluent-Widgets主题系统深度解析

PyQt-Fluent-Widgets A fluent design widgets library based on C++ Qt/PyQt/PySide. Make Qt Great Again. 项目地址: https://gitcode.com/gh_mirrors/py/PyQt-Fluent-Widgets

主题系统概述

PyQt-Fluent-Widgets提供了一套完整的主题管理系统，允许开发者轻松实现应用程序的明暗主题切换和主题色定制。这套系统不仅支持静态主题设置，还能响应系统主题变化，为现代应用程序开发提供了极大的便利。

主题模式详解

主题模式类型

PyQt-Fluent-Widgets支持三种主题模式：

明亮模式(Theme.LIGHT)：采用浅色背景和深色文字的传统界面风格
暗黑模式(Theme.DARK)：采用深色背景和浅色文字的护眼界面风格
自动模式(Theme.AUTO)：自动跟随系统主题设置

主题切换实现

使用setTheme()方法可以轻松切换应用主题：

from qfluentwidgets import Theme, setTheme

# 设置为明亮主题
setTheme(Theme.LIGHT)

# 设置为暗黑主题
setTheme(Theme.DARK)

# 设置为自动跟随系统主题
setTheme(Theme.AUTO)

主题变化通知机制

当主题发生变化时，通过qconfig管理的配置实例会发出themeChanged信号，开发者可以利用这个信号实现界面元素的动态更新。

样式表与主题的集成

自定义样式表类

为了实现主题切换时自动加载对应的样式表，PyQt-Fluent-Widgets提供了StyleSheetBase基类。开发者可以通过继承这个基类来创建自己的样式表管理系统：

from enum import Enum
from qfluentwidgets import StyleSheetBase, Theme, qconfig

class AppStyleSheet(StyleSheetBase, Enum):
    """ 应用程序样式表枚举 """
    MAIN_WINDOW = "main_window"
    SETTINGS_PANEL = "settings_panel"
    
    def path(self, theme=Theme.AUTO):
        theme = qconfig.theme if theme == Theme.AUTO else theme
        return f"resources/qss/{theme.value.lower()}/{self.value}.qss"

样式表应用示例

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        # 应用样式表到主窗口
        AppStyleSheet.MAIN_WINDOW.apply(self)

这种设计模式使得样式表管理变得非常清晰，每个界面元素都有对应的样式表枚举项，并且能根据当前主题自动加载正确的样式文件。

主题色定制

设置主题色

PyQt-Fluent-Widgets允许开发者自定义主题色，为应用程序增添个性化色彩：

from qfluentwidgets import setThemeColor

# 使用十六进制颜色代码
setThemeColor("#0065d5")

# 使用Qt预定义颜色
setThemeColor(Qt.GlobalColor.blue)

# 使用颜色名称
setThemeColor("royalblue")