avalonia自定義標題欄在windows 7環境下的適配方案

問題現象

在 windows 7 系統中使用 avalonia 實現自定義標題欄時，可能會遇到原生標題欄無法隱藏的兼容性問題，導致界面顯示異常：

圖 1：win7 環境下標題欄異常顯示效果

技術分析

這裡感謝微信 【avalonia 開發交流群】 群友的助力：

圖 2：微信群技術交流

avalonia 框架在不同 windows 版本中對窗口裝飾的處理機制存在差異：

1. windows 10/11：默認支持現代窗口樣式，自定義標題欄可正常隱藏原生標題欄
2. windows 7：由於系統 compositor 限制，需要顯式禁用系統裝飾

SystemDecorations属性控制窗口边框和标题栏的显示行为，其枚举值包括：

• Full：完整系统装饰（默认值）
• BorderOnly：仅显示边框
• None：完全禁用系统装饰
• ResizeBorder：仅保留可调整大小的边框

解決方案

通过在窗口初始化代码中显式设置SystemDecorations属性为None，可强制隐藏原生标题栏：

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

        // 关键设置：禁用系统装饰以支持自定义标题栏
        // 在Windows 7环境下必须显式设置，Win10+可省略
        if (OperatingSystem.IsWindows() && !OperatingSystem.IsWindowsVersionAtLeast(6, 2)) // Windows 7及以下
        {
            SystemDecorations = SystemDecorations.None;
        }
    }
}

設置後效果如下，原生標題欄已成功隱藏，自定義標題欄正常顯示：

圖 3：應用修復後的標題欄顯示效果

對了，要支持 win7 aot 運行，不要忘了添加 nuget 包：

<PackageReference Include="YY-Thunks" Version="1.1.8-Beta4" />