WinUI3开发_模态窗口

什么是模态窗口?

模态(Mode)窗口是窗口的一种类型,它的特点就是:在它打开的同时会阻止用户与其父窗口进行交互,直到该模态窗口被关闭为止,一般被应用与对话框,对话框也分为模态和非模态,如果想使用纯Win32实现可以参考我这篇文章:Windows核心编程_窗口蒙版效果

如何在WinUI3上面实现它?

在WinUI3中为我们提供了ContentDialog,WinUI3没有提供非模态窗口,因为如果是非模态的话可以使用Popup或者Flyout来实现。
ContentDialog:
XamlRoot: 指定模态窗口的UI根,该选项用于让模态窗口能够找到要让哪个UI元素进入模态模式,模态情况下会阻塞该
Style: 模态窗口的样式,可以使用资源字典里的样式来自定义它的按钮、Button、动画等样式
Title: 模态窗口标题栏文本
PrimaryButtonText: 主按钮的文本(一般为“确定”、“保存”),是对话框最主要的操作按钮。
SecondaryButtonText: 次按钮文本(一般为“取消”、“不保存”),表示另一种操作选择。
CloseButtonText: 关闭按钮文本(如“关闭”、“取消”),用户点击时视为取消或关闭操作。
DefaultButton: 指定默认选中的按钮,按回车键时会自动点击该按钮。可选值有:None, Primary, Secondary。
Content: 设置模态窗口中间的内容区,可以是简单文本,也可以是复杂控件布局,简单文本可以使用box_value来转换。
ShowAsync: 异步显示对话框,并等待用户点击按钮返回结果。返回类型是ContentDialogResult,可以通过ContentDialogResult来设置Completed回调函数,当模态窗口回调结束时来获取模态窗口执行状态。

首先创建一个ContentDialog变量并设置XamlRoot

ContentDialog dialog;
dialog.XamlRoot(GridRoot().XamlRoot());

这里我使用的是Root布局控件GridXamlRoot作为模态窗口的根元素,这里不局限,也可以使用某个控件的,这样仅针对某个控件进行模态。
然后接下来设置它的样式,这里我使用的是DefaultContentDialogStyle也就是模态窗口的默认样式,注意你需要手动指定它,否则它不使用这个样式,这个样式包含了一些模态窗口的动画效果,如果不使用这个样式模态窗口是没有弹出动画的。

dialog.Style(Application::Current().Resources().TryLookup(box_value(L"DefaultContentDialogStyle")).as<Style>());

然后设置标题主按钮次按钮关闭按钮文本内容和默认选中按钮:

dialog.PrimaryButtonText(L"Save");
dialog.SecondaryButtonText(L"Don't Save");
dialog.CloseButtonText(L"Cancel");
dialog.DefaultButton(ContentDialogButton::Primary);

这里有一点需要补充一下,上面三个按钮如果不想要某个选项,只要不给某个按钮设置文字就可以了,例如我不想要主按钮,只要不使用PrimaryButtonText给它设置文本内容ContentDialog就会默认屏蔽它,例如我只想显示Close一个按钮,只需要调用CloseButtonText就可以了。
接下来设置内容区域文本:

dialog.Content(box)value("Hello World!"));

最后通过ShowAsync并设置compileted事件来判断是什么状态:

auto ret = dialog.ShowAsync();
ret.Completed([](auto&& asyncOp, auto&& status) {
    if (status == winrt::Windows::Foundation::AsyncStatus::Completed)
    {
        try
        {
            auto result = asyncOp.GetResults();

            switch (result)
            {
            case winrt::Windows::UI::Xaml::Controls::ContentDialogResult::Primary:
                OutputDebugStringA("Primary button pressed\n");
                break;

            case winrt::Windows::UI::Xaml::Controls::ContentDialogResult::Secondary:
                OutputDebugStringA("Secondary button pressed\n");
                break;

            case winrt::Windows::UI::Xaml::Controls::ContentDialogResult::None:
                OutputDebugStringA("Dialog closed without choice\n");
                break;

            default:
                OutputDebugStringA("Unknown dialog result\n");
                break;
            }
        }
        catch (const winrt::hresult_error& ex)
        {
            OutputDebugStringA(("Exception: " + std::string(winrt::to_string(ex.message())) + "\n").c_str());
        }
    }
    else if (status == winrt::Windows::Foundation::AsyncStatus::Canceled)
    {
        OutputDebugStringA("Dialog was canceled\n");
    }
    else if (status == winrt::Windows::Foundation::AsyncStatus::Error)
    {
        try
        {
            asyncOp.GetResults(); // 会抛出异常
        }
        catch (const winrt::hresult_error& ex)
        {
            OutputDebugStringA(("Async Error: " + std::string(winrt::to_string(ex.message())) + "\n").c_str());
        }
    }
    });

asyncOp可以获取到当前执行结果,例如点击了哪个按钮,status可以获取到当前窗口执行结果,例如是正常执行结束还是遇到异常结束,它不包含点击了哪个按钮。
执行结果:
在这里插入图片描述
从代码里可以发现在设置TitleContent使用的是box_valuebox_value是一个转换API,在WinUI3里采用万物皆IInspectable的方式来描述一个类,所有的类都可以通过IInspectable来间接转换成对应的类,可以理解IInspectable就是中间类或者Void类型,它是WinRT里的一种类型,WinRT采用IInspectable模板类作为万能类型主要方便于在不同的接口中灵活调用。
box_value就是将某些类转封包成IInspectable,而对应的unbox_value就是拆包,将IInspectable拆回原本的类型,IInspectable的实现非常巧妙,后面有机会我会单独写一篇文章里来讲述IInspectable的实现原理,主要是利用C++RTTI(运行时类型元数据)。
言归正传,TitleContent之所以使用box_value是因为它俩是可以被完全自定义的,它们接受Page类,支持自定义成自己的Page页面类,而IInspectable可以被转换成WinRT任意类型,所以利用box_value将其转换成一个简单的文本Page用于显示。
例如 BlankPage是我自定义的Page,我们可以将它传递给Content作为参数:

BlankPage test;
dialog.Content(test);

这里就不需要使用box_value封装了,因为page本身就是继承自IInspectable,运行效果如下:
在这里插入图片描述
需要值得注意的是,Completed绑定的是自由函数,不能是类成员函数,所以最好使用lambda表达式来做。

<think>好的,用户正在寻找WinUI 3开发教程。首先,我需要回顾之前的对话历史,确保没有重复的信息。用户之前可能已经得到了一些基本指引,比如安装SDK和Template Studio,现在需要更详细的教程资源。 接下来,我应该整理微软官方的文档资源,这是最权威的来源。检查用户提供的引用链接是否正确,确保推荐的步骤如安装环境、使用模板创建项目等都是最新的。同时,可能需要补充一些实际操作的细节,比如如何添加页面和ViewModel,这部分在用户提供的引用中已经提到,但需要更清晰的解释。 然后,考虑推荐视频教程,因为有些开发者更喜欢视觉学习。B站和YouTube上的教程资源需要确认是否仍然有效,并且是否适合初学者。比如推荐入门系列和项目实战,这样用户可以从基础到应用逐步学习。 社区资源方面,Stack Overflow和GitHub是解决问题和获取示例代码的好地方,需要强调这些平台的重要性。此外,书籍推荐也是一个好主意,特别是针对不同经验层次的开发者,比如《深入浅出WinUI 3》可能适合有一定基础的读者,而《WinUI 3实战》则适合项目应用。 用户可能遇到的问题,比如MVVM框架的理解,需要提前预见并给出解决方案。例如,解释MVVM的结构,并推荐相关教程链接,帮助用户更好地掌握这一设计模式。 最后,生成的相关问题需要覆盖用户可能遇到的后续疑问,如环境配置问题、项目结构、MVVM框架、控件使用、跨平台兼容性和社区支持。这些问题能够引导用户进一步探索,解决实际开发中的常见障碍。 确保所有步骤符合系统指令,使用正确的中文表达,数学公式格式正确(虽然这里可能用不上,但需注意)。引用部分要自然,比如在提到官方文档时添加引用标识。同时,保持回答结构清晰,分点说明,便于用户逐步跟随。</think>### WinUI 3 开发教程分步指南 #### 一、环境搭建(官方推荐步骤) 1. **安装Visual Studio 2022** 选择"使用C++的桌面开发"和".NET桌面开发"工作负载,确保勾选"Windows App SDK C# Templates"[^1] 2. **配置Windows App SDK** 通过[官方下载页面](https://aka.ms/windowsappsdk/stable-vs2022-cs)获取最新SDK安装包,注意版本需与Visual Studio兼容 3. **安装Template Studio扩展** 在VS扩展市场中搜索"Template Studio for WinUI",安装后重启VS(注意:安装时需关闭所有VS实例)[^1] #### 二、创建首个WinUI 3项目 ```csharp // 通过Template Studio创建项目时自动生成的典型结构 ├── Services ├── ViewModels // MVVM架构的ViewModel层 ├── Views // 界面层XAML文件 └── Assets // 静态资源 ``` #### 三、核心开发技能 1. **XAML布局基础** 使用`Grid`、`StackPanel`等容器控件: ```xml <Grid> <Button Content="点击我" Click="Button_Click" HorizontalAlignment="Center"/> </Grid> ``` 2. **数据绑定实践** 在ViewModel中实现`INotifyPropertyChanged`接口: ```csharp public class MainViewModel : INotifyPropertyChanged { private string _message; public string Message { get => _message; set => SetField(ref _message, value); } } ``` 3. **现代控件使用** WinUI 3新增的`NavigationView`、`TeachingTip`等控件: ```xml <NavigationView PaneDisplayMode="LeftCompact"> <Frame x:Name="ContentFrame"/> </NavigationView> ``` #### 四、推荐学习资源 1. **微软官方文档** - [Windows App SDK教程](https://learn.microsoft.com/zh-cn/windows/apps/desktop/) - [WinUI 3 Gallery示例源码](https://github.com/microsoft/WinUI-Gallery) 2. **视频教程推荐** - B站系列《WinUI3零基础入门》(含MVVM实战) - YouTube频道「Windows Developer」官方教程 3. **社区资源** - Stack Overflow的[winui-3标签](https://stackoverflow.com/questions/tagged/winui-3) - GitHub趋势项目:Microsoft.Toolkit.WinUI #### 五、常见问题解决方案 1. **XAML Hot Reload失效** 检查项目属性中的目标版本是否≥Windows 10 1809 2. **打包部署问题** 使用MSIX打包时需配置证书: ```powershell New-SelfSignedCertificate -Type Custom -Subject "CN=MyCompany" -KeyUsage DigitalSignature -FriendlyName "MyAppCert" -CertStoreLocation "Cert:\CurrentUser\My" ``` 3. **MVVM框架选择** 推荐使用[CommunityToolkit.MVVM](https://www.nuget.org/packages/CommunityToolkit.Mvvm/)简化实现
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

17岁boy想当攻城狮

感谢打赏

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值