WinUI 3 Gallery 技术文档

最新推荐文章于 2024-11-21 13:12:39 发布
最新推荐文章于 2024-11-21 13:12:39 发布
阅读量750 收藏 9
点赞数 4
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/gitblog_01239/article/details/143049568
版权

WinUI 3 Gallery 技术文档

WinUI-Gallery This app demonstrates the controls available in WinUI and the Fluent Design System. WinUI-Gallery 项目地址: https://gitcode.com/gh_mirrors/wi/WinUI-Gallery

1. 安装指南

1.1 环境准备

在开始安装之前，请确保您的开发环境满足以下要求：

  • 操作系统: Windows 10 或更高版本。
  • 开发工具: Visual Studio 2022 或更高版本。
  • 必备组件:
    • .NET Desktop Development
    • Windows App SDK C# Templates
    • Windows 10 SDK (10.0.19041.0)

如果您是第一次使用 Windows App SDK 开发应用，请按照官方安装指南进行环境配置。

1.2 克隆项目仓库

使用以下命令克隆 WinUI 3 Gallery 项目仓库到本地：

git clone https://github.com/microsoft/WinUI-Gallery.git

1.3 打开并构建项目

  1. 打开 Visual Studio 并导航到克隆的项目目录。
  2. 打开 WinUIGallery\WinUIGallery.DesktopWap.sln 解决方案文件。
  3. 在解决方案资源管理器中，右键点击 WinUIGallery.DesktopWap.Package 项目，并选择“设为启动项目”。
  4. 点击“生成”菜单中的“生成解决方案”以构建项目。

2. 项目的使用说明

2.1 主要功能

WinUI 3 Gallery 是一个展示 WinUI 3 控件和样式的示例应用，主要功能包括：

  • WinUI 控件示例: 每个控件页面展示了创建示例所需的标记和代码。
  • 使用 Microsoft.UI.Xaml 库: 应用包含最新的 WinUI NuGet 包，并展示了如何使用 NavigationView、SwipeControl 等控件。
  • 基本布局: 展示了应用中所有可能的布局选项，并允许用户与面板交互，以展示如何实现所需的布局。
  • 自适应 UI: 展示了每个控件在不同设备上的响应方式，应用本身也是响应式的，展示了实现自适应 UI 的各种方法。
  • 设计与可访问性指南: 设计和可访问性页面帮助开发者更好地使用该应用。
  • 版本自适应代码: 展示了如何编写版本自适应代码，使应用能够在旧版本的 Windows 上运行，同时在新版本上使用最新功能。

2.2 使用方法

  1. 启动应用: 在 Visual Studio 中，按 F5 键启动应用。
  2. 浏览控件: 应用启动后，您可以浏览各个控件页面，查看示例代码和标记。
  3. 交互体验: 通过与控件交互，了解其在不同布局和设备上的表现。

3. 项目API使用文档

3.1 WinUI 控件 API

WinUI 3 Gallery 展示了多种 WinUI 控件的使用方法，以下是一些常用控件的 API 说明：

  • NavigationView: 用于创建应用的导航菜单。
    • IsPaneOpen: 控制导航窗格的打开状态。
    • MenuItems: 导航菜单项的集合。
  • SwipeControl: 用于实现滑动操作。
    • LeftItems: 左侧滑动操作的集合。
    • RightItems: 右侧滑动操作的集合。
  • CommandBar: 用于创建命令栏。
    • PrimaryCommands: 主要命令的集合。
    • SecondaryCommands: 次要命令的集合。

3.2 自适应布局 API

WinUI 3 Gallery 展示了如何使用自适应布局 API 来实现不同设备上的 UI 适配：

  • VisualStateManager: 用于管理视觉状态。
    • GoToState: 切换到指定的视觉状态。
  • AdaptiveTrigger: 用于根据窗口大小调整布局。
    • MinWindowWidth: 最小窗口宽度触发器。
    • MinWindowHeight: 最小窗口高度触发器。

4. 项目安装方式

WinUI 3 Gallery 可以通过以下方式安装：

  1. 从 Microsoft Store 安装: 访问 Microsoft Store 下载并安装应用。
  2. 本地构建安装: 按照上述安装指南，在本地构建并运行应用。

通过以上步骤，您可以顺利安装并使用 WinUI 3 Gallery 应用，深入了解 WinUI 3 控件和样式的使用方法。

WinUI-Gallery This app demonstrates the controls available in WinUI and the Fluent Design System. WinUI-Gallery 项目地址: https://gitcode.com/gh_mirrors/wi/WinUI-Gallery

【WinUI 3】自定义标题栏的颜色透明化
XiaoLi8848的博客
06-24 1509
在自定义WinUI 3窗口的标题栏后，其默认颜色是系统主题色。通过设置App资源和调用Win32 API即可实现透明标题栏颜色。
winUI3 c++ 入门 2、 样式
清流弯弯
10-16 1155
目录一、winUI3 基本概念及样式1、边距2、如何使用样式1）、布局控件内定义样式2）、APP.xmal定义全局样式3）、单独的样式文件3.1)、新增字典资源 xmal3.2）、在里面设置样式3.3）、引用样式3、更多样式修改1）、修改默认属性2）、修改所有的默认颜色3）、样式继承4、示例Margin 值可以是统一的，也可以是不同的。 在使用 时，将对元素的左侧、顶部、右侧和底部应用 20 像素的统一边距。 在使用 时，将左侧、顶部、右侧和底部（按此顺序）分别应用不同的值。
推荐项目：WinUI 3 Gallery —— 打造现代Windows应用的灵感库
gitblog_00945的博客
08-25 1363
推荐项目：WinUI 3 Gallery —— 打造现代Windows应用的灵感库 项目地址:https://gitcode.com/gh_mirrors/wi/WinUI-Gallery 在追求极致用户体验和现代化界面设计的今天，WinUI 3 Gallery 成为了开发者不可或缺的强大工具。这款开源项目，作为WinAppSDK的配套样本应用，不仅展现了WinUI 3控制的所有能力和风格，更是...
WinUI3-读写.json文件
White--Night的博客
05-25 968
通过json文件将用户数据保存至本地
推荐文章：探索现代Windows应用开发的利器 —— WinUI 3
gitblog_00224的博客
08-07 1126
推荐文章：探索现代Windows应用开发的利器 —— WinUI 3 microsoft-ui-xamlWindows UI Library: the latest Windows 10 native controls and Fluent styles for your applications项目地址:https://gitcode.com/gh_mirrors/mi/microsoft-u...
WinUI3 Chart(图表)——饼状图
weixin_43780907的博客
08-15 750
2、在下图PM后输入 NuGet\Install-Package LiveChartsCore.SkiaSharpView.WinUI -Version 2.0.0-beta.911。在ViewModel中 ：注意msyh.ttc是从电脑系统中的字体下载下来的微软雅黑字体，使用它用来支持中文字体，把它放入生成的Debug文件夹下。借鉴网址：https://www.lvcharts.com/docs/winui/2.0.0-beta.850/gallery。
WinUI3 主题（APPTheme）设置
weixin_43780907的博客
08-15 989
4、改为WinUI3 Gallery Dev里的Setting模式；主要要实现其中的点击功能，不然运行报错，例如实现下面的SelectionChanged="themeMode_SelectionChanged 方法。3、项目中会出现SettingsPage功能，如果需要单独的Settings功能可以新键一个没有添加设置的工程，对比后提取出需要Setting的文件放入空白工程。1、使用“用于WInUI的Template Studio”模板创建项目。5、在App.xaml.cs中加入依赖。
WinUI-3-Demos
04-22
这些是一些示例来演示WinUI 3的用法 更新到唯一的URL存根 官方Microsoft示例 先决条件 按照上的说明配置开发环境 贡献 该项目欢迎您的贡献和建议。 大多数捐款要求您同意一份《捐款者许可协议》（CLA），声明您有权...
winui-docs:Syncfusion WinUI控件文档
04-06
Syncfusion WinUI文档 这是Syncfusion WinUI组件技术产品文档的GitHub存储库。 本文档已发布到 捐款欢迎！ 我们欢迎以改进WinUI组件用户指南文档。 您对此的贡献将不胜感激。
VS2019 扩展程序 Project Reunion 0.5 WinUI3 控件库示例
06-23
Windows UI 库 (WinUI) 3 是用于构建新式 Windows 应用的原生用户体验 (UX) 框架。 它独立于 Windows 操作系统，作为 Project Reunion 的一部分提供。 Project Reunion 0.5 版本提供 Visual ...另附WinUI3控件库示例
Xaml-Controls-Gallery:此应用程序演示了 WinUI 和 Fluent Design System 中可用的控件
08-03
使用 Microsoft.UI.Xaml (WinUI) 库：该应用程序包含最新的 WinUI NuGet 包，并展示如何使用控件，如 NavigationView、SwipeControl 等。 基本布局：此示例将显示您的应用程序的所有可能的布局选项，并允许您与...
Winui3内容扩展到标题栏
静心学习，开心生活
05-05 439
Winui3扩展到标题栏
WinUI-Gallery 开源项目教程
gitblog_00761的博客
08-23 1195
WinUI-Gallery 开源项目教程 WinUI-GalleryThis app demonstrates the controls available in WinUI and the Fluent Design System.项目地址:https://gitcode.com/gh_mirrors/wi/WinUI-Gallery 项目介绍 WinUI-Gallery 是由微软开发的一个开...
winUI3 入门 3 基本控件 Button、Checkbox
清流弯弯
10-21 1380
- 为按钮定义一个带有悬停效果的样式 -->-- 自定义模板 -->-- 定义背景 -->-- 显示按钮内容 -->-- 定义 VisualState 管理器 -->-- 鼠标悬停效果 -->-- 动态改变背景颜色 -->-- 按下按钮效果 -->-- 正常状态 -->
Win UI3开发笔记（四）设置主题续
静心学习，开心生活
02-27 1028
无
WinUI-Gallery 项目常见问题解决方案
gitblog_00406的博客
11-21 390
WinUI-Gallery 项目常见问题解决方案 WinUI-Gallery This app demonstrates the controls available in WinUI and the Fluent Design System. ...
Win UI3开发笔记（四）设置主题
静心学习，开心生活
02-25 1757
无
Win UI3开发笔记（九）关于图标Win10乱码问题
静心学习，开心生活
04-02 717
无
春风十里不如你，全新Windows UI 3(WinUI 3) 的第一个实现Project Reunion 0.5
weixin_45131680的博客
10-16 2499
Windows UI库 (WinUI) 是适用于 Windows 桌面应用程序和 UWP 应用程序的本机用户体验 (UX) 框架。WinUI‎WinUI是一个用户界面层，包含用于构建Windows应用的现代控件和样式。‎‎作为Windows中的原生UI层，它体现了‎‎流畅的设计‎‎，为每个Windows应用提供了客户所期望的抛光感觉。‎通俗一点理解，WinUI将UWP的UI层从的其它部分分离，并将从Windows转移到Nuget。现在建一个C++或C#(.NET 5)程序，再从Nuget上装个。
win ui3
最新发布
03-23
<think>嗯，用户之前问过MFC的情况，现在又问WinUI 3，可能是在寻找替代MFC的现代框架。首先，我需要确认用户的需求，他们可能是在考虑开发新的Windows应用程序，或者维护旧项目时需要升级技术栈。用户可能是开发者，特别是那些有C++或C#背景的，或者是对微软技术栈感兴趣的人。 接下来，我需要介绍WinUI 3的基本信息，包括它是微软的新框架，支持Windows 10/11，以及它的核心优势。要对比之前的MFC，突出WinUI 3的现代化特性，比如Fluent Design、声明式UI、性能优化等。同时，应该提到它与其他框架如WPF、UWP的关系，帮助用户理解其定位。 用户可能关心适用场景，比如什么时候选择WinUI 3，是否有跨平台需求，开发效率如何。需要明确WinUI 3适合需要原生Windows体验的项目，而不适合跨平台的情况。此外，要提到WinUI 3的社区支持和学习资源，因为这对于开发者来说很重要。 还要考虑用户可能没有说出来的深层需求，比如迁移现有MFC应用到WinUI 3是否可行，或者如何开始学习。虽然用户没直接问，但应该在回答中提供一些指导，比如建议使用C#或C++，推荐学习路径，以及如何获取社区支持。 最后，总结部分要简明扼要，帮助用户做决定。强调WinUI 3是微软重点发展的方向，适合新项目，而旧项目维护可能需要结合其他技术。确保信息准确，结构清晰，分点说明，便于用户理解。</think>好的，以下是关于 **WinUI 3** 的详细介绍，从技术特性到实际应用场景的全面分析： --- ### 一、**WinUI 3 的定位与核心特性** **WinUI 3**（Windows UI Library 3）是微软推出的 **现代化原生UI框架**，属于 **Windows App SDK** 的核心组件，专为开发高性能、高视觉质量的 **Windows 10/11 原生应用** 设计。 其核心优势包括： 1. **原生与现代化** - 完全脱离传统 Win32 限制，支持 **Fluent Design 2.0**（Windows 11 风格动画、圆角控件、Mica材质特效） - 直接调用 **Windows 原生API**，无中间层性能损耗 - 支持 **DirectX 12** 渲染（适合游戏或图形密集型应用） 2. **开发模式革新** - **声明式UI**：通过 XAML 定义界面（类似 WPF/UWP） - **数据绑定**：支持 MVVM 模式（Model-View-ViewModel） - **热重载**：实时预览界面修改效果（需搭配 Visual Studio 2022） 3. **兼容性与独立性** - 可独立更新（不依赖系统版本，通过 NuGet 包管理） - 支持 **C#、C++/WinRT、Rust** 等多种语言开发 --- ### 二、**与同类技术的对比** | 框架 | 技术路线 | 适用场景 | 性能表现 | 跨平台能力 | |--------------|---------------|--------------------------|---------------|------------| | **WinUI 3** | 原生Windows | 新Windows应用 | 高（原生API） | 仅Windows | | WPF | .NET Framework| 企业级桌面应用 | 中（托管代码） | 仅Windows | | UWP | 沙箱化 | 应用商店轻量级应用 | 中高 | 仅Windows | | Qt | C++跨平台 | 工业/跨平台应用 | 高 | 支持多平台 | | Avalonia | .NET跨平台 | 跨平台XAML应用 | 中 | 支持多平台 | --- ### 三、**典型应用场景** #### ✅ **推荐使用 WinUI 3 的情况** 1. **开发全新 Windows 原生应用** - 需要深度集成 Windows 11 特性（如通知中心、任务栏跳转列表） - 示例：微软新版 **画图**、**照片** 应用已采用 WinUI 3 2. **高性能图形需求** - 3D建模工具、实时数据仪表盘（利用 DirectX 加速） 3. **企业级工具升级** - 替换老旧 MFC/WinForms 项目，同时保留 C++ 代码库 #### ❌ **不适合 WinUI 3 的情况** - 需要兼容 Windows 7/8 的系统 - 要求快速支持 iOS/Android 的跨平台项目 --- ### 四、**技术架构与关键组件** 1. **核心架构图** ```plaintext +---------------------+ | 应用程序层 (C#/C++/Rust) | +---------------------+ | WinUI 3 | ← XAML 界面 + 数据绑定 +---------------------+ | Windows App SDK | ← 系统服务抽象层 +---------------------+ | Windows API | ← 原生系统调用 +---------------------+ ``` 2. **关键组件** - **Fluent Design Controls**：现代化按钮、导航栏、列表等 - **Composition API**：实现高级动画（如粒子效果、视差滚动） - **WebView2**：内嵌 Chromium 内核浏览器（替代旧版 WebView） --- ### 五、**开发成本与学习曲线** 1. **学习成本** - 若熟悉 WPF/UWP：约 1-2 周可上手 - 零基础开发者：需掌握 XAML 语法和 MVVM 模式（约 1 个月） 2. **开发工具链** - 必需工具：Visual Studio 2022（版本 17.4+） - 推荐扩展： - WinUI 3 Templates（官方项目模板） - XAML Styler（自动格式化 XAML 代码） 3. **社区资源** - 官方文档：[Microsoft Learn WinUI 教程](https://learn.microsoft.com/zh-cn/windows/apps/winui/) - 开源示例：GitHub 的 [Windows UI Library 示例库](https://github.com/microsoft/WinUI-Gallery) --- ### 六、**局限性及应对方案** | 局限性 | 应对策略 | |-----------------------|---------------------------------| | 不支持 Windows 7/8 | 使用 WPF 或 Qt 兼容旧系统 | | 社区生态较新 | 结合微软官方论坛和 Stack Overflow | | 移动端需另选框架 | 搭配 .NET MAUI 实现跨平台 | --- ### 七、**总结与建议** - **选择 WinUI 3 的条件**： - 目标用户为 Windows 10/11 用户 - 追求现代化视觉效果和原生性能 - 需要长期维护的新项目 - **替代方案推荐**： - 需要兼容旧系统 → **WPF** - 跨平台需求 → **Avalonia** 或 **.NET MAUI** - **未来展望**： WinUI 3 是微软 **Windows 开发生态的核心方向**，预计将持续获得官方资源投入，适合作为 Windows 原生开发的长期技术选型。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

打赏作者

祖韬锁

你的鼓励将是我创作的最大动力

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

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

打赏作者

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

抵扣说明：

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

余额充值