WPF 的原生窗体标题栏主题自适应系统深浅主题

不知名君2026-04-18 11:03

TitlebarAdaptive.WPF

Github地址
TitlebarAdaptive.WPF 是一个用于 WPF 的标题栏主题适配辅助库，可以让窗口标题栏跟随 Windows 系统的浅色/深色模式自动切换，也支持手动指定标题栏颜色。

特性

自动跟随系统主题变化
支持手动设置标题栏浅色/深色
适用于 WPF 窗口
支持多目标框架：
- .NET Framework 4.6.2
- .NET Framework 4.8
- .NET 8
- .NET 10
可打包为 NuGet 库发布

安装方式

方法 1：通过 NuGet 包管理器安装

在 Visual Studio 中打开 NuGet 包管理器，搜索并安装：

TitlebarAdaptive.WPF

方法 2：通过包管理器控制台安装

powershell 复制代码

Install-Package TitlebarAdaptive.WPF

方法 3：通过 .NET CLI 安装

powershell 复制代码

dotnet add package TitlebarAdaptive.WPF

使用方式

在窗口上启用自适应标题栏：

xml 复制代码

<Window
    ...
    xmlns:wpf="clr-namespace:TitlebarAdaptive.WPF;assembly=TitlebarAdaptive.WPF"
    wpf:OriginalWindowHelper.Adaptive="True" />

手动指定标题栏颜色：

xml 复制代码

<Window
    ...
    xmlns:wpf="clr-namespace:TitlebarAdaptive.WPF;assembly=TitlebarAdaptive.WPF"
    wpf:OriginalWindowHelper.Adaptive="False"
    wpf:OriginalWindowHelper.TitleBarIsLight="True" />

属性说明

Adaptive="True"：自动跟随系统主题
Adaptive="False"：关闭自动适配，使用手动设置
TitleBarIsLight="True"：浅色标题栏
TitleBarIsLight="False"：深色标题栏
TitleBarIsLight="null"：不指定标题栏颜色

项目结构

TitlebarAdaptive.WPF：核心库
TitlebarAdaptive.Demo：演示程序