MetroRadiance 技术文档

1. 安装指南

为了使用 MetroRadiance，你需要通过 NuGet 包管理器安装以下包：

• MetroRadiance.Core：MetroRadiance 核心库。
• MetroRadiance.Chrome：为 WPF 窗口添加类似 Visual Studio 的窗口边框。
• MetroRadiance：WPF 自定义控件库。

安装命令如下：

PM> Install-Package MetroRadiance

2. 项目的使用说明

MetroRadiance.Core

• DPI/Per-Monitor DPI 支持
  • 获取系统 DPI
  • 从 HwndSource 或窗口句柄获取显示器 DPI

using MetroRadiance.Interop;

// 获取系统 dpi
var systemDpi = window.GetSystemDpi();

if (PerMonitorDpi.IsSupported)
{
    // 获取显示器 dpi。
    var hwndSource = (HwndSource)PresentationSource.FromVisual(this);
    var monitorDpi = hwndSource.GetDpi();
}

• Windows 主题支持
  • 获取 Windows 主题（仅限 Windows 10，支持浅色或深色主题）
  • 获取 Windows 色彩
  • 订阅 Windows 主题颜色变更事件

using MetroRadiance.Platform;

// 获取 Windows 色彩
var color = WindowsTheme.GetAccentColor();

// 订阅 Windows 主题色彩变更事件
var disposable = WindowsTheme.RegisterAccentColorListener(color =>
{
    // 将色彩应用到你的应用中。
});

// 取消订阅颜色变更事件
disposable.Dispose();

• HSV 颜色模型支持

using MetroRadiance.Media;

// 获取 Windows 色彩（使用 MetroRadiance.Platform;）
var rgbColor = WindowsTheme.GetAccentColor();

// 从 RGB 转换为 HSV 颜色。
var hsvColor = rgbColor.ToHsv();
hsvColor.V *= 0.8;

// 从 HSV 转换为 RGB 颜色。
var newColor = hsvColor.ToRgb();

MetroRadiance.Chrome

• 为 WPF 窗口添加类似 Visual Studio 的窗口边框
  • MetroRadiance.Chrome.WindowChrome

<Window xmlns:chrome="http://schemes.grabacr.net/winfx/2014/chrome">
    <chrome:WindowChrome.Instance>
        <chrome:WindowChrome />
    </chrome:WindowChrome.Instance>
</Window>

• 将任何 UI 元素添加到窗口边框
  • MetroRadiance.Chrome.WindowChrome.Top / .Left / .Right / .Bottom

<Window xmlns:chrome="http://schemes.grabacr.net/winfx/2014/chrome">
    <chrome:WindowChrome.Instance>
        <chrome:WindowChrome>
            <chrome:WindowChrome.Top>
                <Border Background="DarkRed"
                        Padding="24,3"
                        Margin="8,0"
                        HorizontalAlignment="Right">
                    <TextBlock Text="任何 UI 元素"
                               Foreground="White" />
                </Border>
            </chrome:WindowChrome.Top>
        </chrome:WindowChrome>
    </chrome:WindowChrome.Instance>
</Window>

MetroRadiance

• 主题支持

// 更改主题。
ThemeService.Current.ChangeTheme(Theme.Dark);

// 更改主题（与 Windows 同步）
ThemeService.Current.ChangeTheme(Theme.Windows);

// 更改色彩。
ThemeService.Current.ChangeAccent(Accent.Blue);

// 更改色彩（与 Windows 同步）
ThemeService.Current.ChangeAccent(Accent.Windows);

// 更改色彩（从 RGB 颜色）
var accent = Colors.Red.ToAccent();
ThemeService.Current.ChangeAccent(accent);

• 自定义控件
• 自定义行为
• 自定义转换器

3. 项目 API 使用文档

由于篇幅限制，这里不详细列出所有 API 文档。用户可以参考 GitHub 项目 Wiki 或官方文档来获取详细的 API 使用说明。

4. 项目安装方式

项目安装方式已在“安装指南”一节中说明，用户可以通过 NuGet 包管理器安装所需的包。