Avalonia Windows 7 标题栏适配方案

问题描述

在Windows 7操作系统中，使用Avalonia框架实现自定义标题栏时，可能出现原生窗口标题栏无法正常隐藏的兼容性问题，导致界面布局错乱或双标题栏现象：

图1：Win7环境下标题栏异常显示效果

原因剖析

特别感谢微信 【Avalonia开发交流群】 中群友提供的技术支持与思路分享：

图2：微信群技术交流

Avalonia在不同版本的Windows系统中对窗口装饰（如标题栏、边框）的渲染机制有所不同：

• Windows 10/11：支持现代化的DWM合成器，能够自动处理无边框窗口，自定义标题栏可顺利替代原生标题栏
• Windows 7：由于系统合成器功能限制，若不主动干预，即使设置了无边框，系统仍会保留默认标题栏区域

其中，SystemDecorations 属性用于控制窗口的系统级装饰样式，其可选值包括：

• Full：显示完整的系统标题栏和边框（默认）
• BorderOnly：仅显示窗口边框，无标题栏
• None：完全关闭系统装饰，实现真正无边框
• ResizeBorder：仅保留可调整大小的边框，无标题栏

实施方案

为解决Windows 7下标题栏无法隐藏的问题，需在窗口初始化时强制关闭系统装饰。具体代码如下：

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();

        // 关键配置：禁用系统装饰以实现自定义标题栏
        // 该设置在Windows 7及更早版本中必不可少
        if (OperatingSystem.IsWindows() && 
            !OperatingSystem.IsWindowsVersionAtLeast(6, 2)) // 对应Windows 7及以下
        {
            SystemDecorations = SystemDecorations.None;
        }
    }
}

完成设置后，原生标题栏被成功移除，自定义标题栏可正常渲染，显示效果如下：

图3：应用修复后的标题栏显示效果

补充说明：若需在Windows 7上运行AOT编译的应用，建议引入以下NuGet包以确保系统API兼容性：

<packagereference include="YY-Thunks" version="1.1.8-Beta4"></packagereference>