【亲测免费】 py-window-styles 项目教程

2026-01-21 05:24:52作者：董灵辛Dennis

1. 项目介绍

py-window-styles 是一个用于自定义 Python UI 窗口样式的开源库。它提供了预构建的 Windows 11 标题栏样式和主题，同时也支持 Windows 10 的主题。该库易于使用，功能强大且可定制，适用于多种 Python GUI 库，如 Tkinter、Customtkinter、PyQt、PySide、WxPython、Pygame、Kivy 和 PySimpleGUI 等。

主要特点

简单易用：只需几行代码即可将 Windows 11 主题和样式应用到你的窗口。
预构建主题和样式：提供多种预构建的 Windows 11 主题和样式，满足不同的设计需求。
广泛的库支持：支持多种 Python GUI 库。
可定制性：可以根据需要调整主题和样式的各个方面，例如颜色、字体、图标等。
开源免费：所有人都可以免费使用和修改该库。

2. 项目快速启动

安装

首先，你需要安装 pywinstyles 库。可以使用 pip 命令进行安装：

pip install pywinstyles

基本使用

以下是一个简单的示例，使用 Tkinter 库创建一个窗口，并应用 Windows 11 主题：

import tkinter as tk
import pywinstyles

# 创建一个窗口
root = tk.Tk()

# 应用 Windows 11 主题
pywinstyles.apply_style(root, "dark")

# 添加一些内容
label = tk.Label(root, text="Hello, World!")
label.pack()

# 运行窗口
root.mainloop()

自定义主题和样式

除了使用预构建的主题和样式，你还可以自定义主题和样式。例如，更改颜色、字体、图标等：

import tkinter as tk
import pywinstyles

# 创建一个窗口
root = tk.Tk()

# 自定义主题
theme = {
    "background_color": "#222",
    "foreground_color": "#fff",
    "font": ("Arial", 12),
    "icon": "path/to/icon.ico"
}

# 应用自定义主题
pywinstyles.apply_theme(root, theme)

# 添加一些内容
label = tk.Label(root, text="Hello, World!")
label.pack()

# 运行窗口
root.mainloop()

3. 应用案例和最佳实践

应用案例

创建现代化的桌面应用程序：使用 py-window-styles 可以轻松为你的桌面应用程序添加现代化的 Windows 11 风格，提升用户体验。
自定义 GUI 工具：无论是简单的计算器还是复杂的图形编辑器，py-window-styles 都可以帮助你快速定制窗口样式，使其更加美观和专业。