WinUI 3 踩坑记：第一个窗口

🚀 优质资源分享 🚀

本文是 WinUI 3 踩坑记 的一部分，该系列发布于 GitHub@Scighost/WinUI3Keng，文中的代码也在此仓库中，若内容出现冲突以 GitHub 上的为准。

WinUI 3 应用的入口和 UWP 类似，也是继承自 Application 的一个类，略有不同的是没有 UWP 那么多的启动方式可供重写，只有一个 OnLaunched 可以重写。OnLaunched 中的内容很简单，就是构造一个主窗口并激活。

// App.xaml.cs

public partial class App : Application
{
    public App()
    {
        this.InitializeComponent();
    }

    protected override void OnLaunched(Microsoft.UI.Xaml.LaunchActivatedEventArgs args)
    {
        // 构造一个主窗口并激活
        m_window = new MainWindow();
        m_window.Activate();
    }

    private Window m_window;
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

本文将聚焦于主窗口 MainWindow，介绍 设置云母或亚克力背景、调整窗口位置大小、自定义标题栏 等内容。

设置云母或亚克力背景

设置背景材质的方法在官方文档中有很详细的方法，不再过多介绍，本文中使用的是我个人封装的方法，源码在这。

// MainWindow.xaml.cs
using Scighost.WinUILib.Helpers;

private SystemBackdropHelper backdropHelper;

public MainWindow()
{
    this.InitializeComponent();
    backdropHelper = new SystemBackdropHelper(this);
    // 设置云母背景，如果不支持则设置为亚克力背景
    backdropHelper.TrySetMica(fallbackToAcrylic: true);
}


1
2
3
4
5
6
7
8
9
10
11
12
13
14

调整窗口位置大小

创建窗口后的第一件事儿是干什么？
没错，就是获取窗口句柄(HWND)，这个流程和 WPF/UWP 截然不同，倒是和 Win32 很像。因为窗口类 Microsoft.UI.Xaml.Window 中几乎没有与窗口状态有关的方法，而所谓的 HWND 高级封装类 Microsoft.UI.Windowing.AppWindow 包含的方法也很有限，并且需要通过窗口句柄才能获取。相比之下 WPF 几乎封装了所有关于窗口的常见操作，可见 WPF 在开发体验方面更胜一筹。

// MainWindow.xaml.cs
// 命名空间真™乱
using Microsoft.UI;
using Microsoft.UI.Windowing;
using Microsoft.UI.Xaml;
using WinRT.Interop;

priva
1
2
3
4
5
6
7