Windows Community Toolkit 3.0 新功能在WinForms 和 WPF 使用 UWP 控件

2023-08-11 07:55:28

本文告诉大家一个令人震惊的消息，Windows Community Toolkit 有一个大更新，现在的版本是 3.0 。最大的提升就是 WinForm 和 WPF 程序可以使用部分 UWP 控件。

而且可以在 WPF 和 WinForms 使用微软最新 Edge 浏览器

本文翻译Announcing Windows Community Toolkit v3.0，因为水平比较渣，请大家不要喷太多。

在几周前，微软改名部拿到很多经费，成功把 UWP Community Toolkit 改名为 Windows Community Toolkit ，因为微软觉得这个名字能更好表示微软和很多开发者一起开发。修改命名就是最大的更新，本文完（不要打我）

新的版本的不重要的更新是

支持在 WPF 和 WinForms 使用新的控件，包括 Edge 浏览器
所有的 UWP 可以在 Xaml 开启 eye gaze Api
提供新的包用来写 runtime API 的检查
提供 Microsoft Graph 控件
现有的大量控件
对所有控件支持亮主题和暗主题
性能提升和修改bug

新的支持 WPF 的 WebView

微软开发了新的 Microsoft Edge 渲染引擎，可以在 WinForms 和 WPF 使用。如果使用一个全新的控件，大量的现有的程序员会感到陌生，所以微软封装了控件，尽可能让开发者感觉到熟悉。这个控件就是WebViewControl，这个控件有大量的 API 和原有的 WinForms 和 WPF 的web控件相同。

下面就是分别运行在 WinForms 和 WPF 的 WebViewControl 。使用新的 WebViewControl 可以支持 EdgeHTML 和流畅触摸，而且去掉很多 Internet Explorer 存在的坑。

现在通过 Nuget 安装 Microsoft.Toolkit.Win32.UI.Controls 就可以在 WinForms 和 WPF 使用 Edge 浏览器。

如果需要看详细的文档，请点这个链接

所有的Xaml控件支持视线输入

可以想一下，如果我不需要用手，就用眼神就可以控制程序。不要以为这个科技很远，微软提供了对所有 Xaml 控件添加 eye gaze API 支持。

只需要安装Microsoft.Toolkit.Uwp.Input.GazeInteraction 就可以在 Xaml 使用下面代码，让控件支持视线输入。

xmlns:gaze="using:Microsoft.Toolkit.Uwp.Input.GazeInteraction"

        gaze:GazeInput.Interaction="Enabled"

这个API支持让你控制视线输入在界面如何处理，如果对这个有兴趣，请点击链接来学习更多内容。官方的文档请点击链接

平台检查

因为现在有支持多平台的 csproj ，所以在写代码时经常需要判断当前是在哪个平台。

因为 UWP 开发需要指定最低平台，而且对不同的平台可以不同的 API ，以前只能通过看文档才知道现在有哪些API是可以使用的，现在可以安装Microsoft.Toolkit.Uwp.PlatformSpecificAnalyzer来检查。这个库是一个 Roslyn 分析库，在编译时可以帮助检查是否使用了一些特殊平台才可以使用的接口。可以自动提示这个接口的平台，自动生成代码。

Microsoft Graph 控件

支持 Microsoft Graph 控件，可以快速在 Xaml 使用 Microsoft Graph 控件。下面就是提供的一些控件

ProfileCard 和 AadLogin

在 ProfileCard 可以简单显示一个用户的多个不同格式信息，包括用户的名字、头像和邮件。同时 AadLogin 支持通过 Microsoft Graph 服务器使用Azure Active Directory (AAD) 登陆。

PeoplePicker

从一个组织的 AD 里面选择一个或多个用户的控件

SharePointFileList

让用户可以在点击文件夹或文件时快速预览 SharePoint 文件

新控件和辅助方法

下面是一些值得一提的控件和辅助方法

CameraHelper 和 CameraPreview

通过 CameraHelper 可以简单拿到相机的一帧保存到 preview video 、capture video frames 或 software bitmaps。通过一行代码，开发者就可以获得实时相机拍到的图片。

如果需要预览相机，只需要在 xaml 添加下面代码

<controls:CameraPreview x:Name="CameraPreviewControl">

</controls:CameraPreview>

在后台代码相机刷新更改界面

await CameraPreviewControl.StartAsync();

CameraPreviewControl.CameraHelper.FrameArrived += CameraPreviewControl_FrameArrived;

如果感兴趣，请点击链接看更多文档

UniformGrid

这是一个在 WPF 很常用，很好用的控件。如果是从 WPF 迁移代码，只需要修改代码的空间就可以，其他都不需要修改。如果是 WPF 开发者，那么相信很熟悉 UniformGrid ，但是我还是需要做很小的描述，这个控件不需要定义行列，有很多个单元格，每个单元格的大小相同，而且一个单元格只能放一个控件。和 WPF 不同的是，新的 UniformGrid 支持设置某个元素所在的行列，详细的文档请看本章后面的参见。

如下面的代码

<controls:UniformGrid>

      <Border Background="AliceBlue" Grid.Row="1" Grid.Column="1"><TextBlock Text="1"/></Border>

      <Border Background="Cornsilk"><TextBlock Text="2"/></Border>

      <Border Background="DarkSalmon"><TextBlock Text="3"/></Border>

      <Border Background="Gainsboro"><TextBlock Text="4"/></Border>

      <Border Background="LightBlue"><TextBlock Text="5"/></Border>

      <Border Background="MediumAquamarine"><TextBlock Text="6"/></Border>

      <Border Background="MistyRose"><TextBlock Text="7"/></Border>

    </controls:UniformGrid>

运行界面