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

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：通过包管理器控制台安装

Install-Package TitlebarAdaptive.WPF

方法 3：通过 .NET CLI 安装

dotnet add package TitlebarAdaptive.WPF

使用方式

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

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

手动指定标题栏颜色：

<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：演示程序