Avalonia开发Windows应用：如何自定义窗口类名？

要让外部应用能通过固定类名捕获你的Avalonia窗口，你可以通过Windows平台特定的API自定义窗口类名，以下是具体实现步骤：

针对Avalonia 11.x版本 #

1. 确保项目已引用Avalonia.Win32 NuGet包（默认Avalonia桌面模板已包含）
2. 在应用初始化时注册自定义窗口类，并为窗口指定该类名，示例代码如下：

using Avalonia;
using Avalonia.Win32;
using Avalonia.Controls.ApplicationLifetimes;

public class App : Application
{
    public override void Initialize()
    {
        AvaloniaXamlLoader.Load(this);
    }

    public override void OnFrameworkInitializationCompleted()
    {
        if (ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop)
        {
            // 注册自定义窗口类，替换成你需要的类名
            const string CustomWindowClass = "MyAppMainWindow";
            Win32Window.RegisterCustomWindowClass(CustomWindowClass);

            desktop.MainWindow = new MainWindow();
            
            // 为主窗口设置自定义类名
            if (desktop.MainWindow.PlatformImpl is IWin32Window win32Window)
            {
                win32Window.WindowClass = CustomWindowClass;
            }
        }

        base.OnFrameworkInitializationCompleted();
    }
}

针对Avalonia 0.10.x及更早版本 #

API略有不同，需使用WindowImplWin32类：

using Avalonia.Win32;

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

#if WINDOWS
        const string CustomWindowClass = "MyLegacyAppWindow";
        WindowImplWin32.RegisterCustomWindowClass(CustomWindowClass);
        
        if (PlatformImpl is WindowImplWin32 win32Impl)
        {
            win32Impl.WindowClass = CustomWindowClass;
        }
#endif
    }
}

注意事项 #

• 自定义类名需确保唯一，避免与系统或其他应用的窗口类名冲突
• 所有Windows平台特定代码建议用#if WINDOWS条件编译包裹，保证跨平台编译正常
• 修改后重启应用，用Spy++查看窗口类名，确认已生效

内容的提问来源于stack exchange，提问作者许树顺