快速上手WinFormium：用HTML5构建现代化Windows桌面应用

快速上手WinFormium：用HTML5构建现代化Windows桌面应用

【免费下载链接】NanUINanUI is an open source .NET project for .NET developers who want to create desktop applications with HTML, CSS and JavaScript.项目地址: https://gitcode.com/gh_mirrors/na/NanUI

WinFormium是一个基于Chromium Embedded Framework（CEF）的开源项目，让.NET开发者能够使用HTML5、CSS3和JavaScript等前端技术来创建功能丰富的Windows桌面应用程序。本文将带你从零开始，在10分钟内创建你的第一个WinFormium应用。

开发环境快速配置

开始之前，请确保你的环境满足以下要求：

必备组件：

• Visual Studio 2019或更高版本
• .NET 6.0 SDK或更高版本

三步创建你的首个WinFormium应用

第一步：创建项目基础结构

打开Visual Studio，选择创建新的Windows窗体应用项目。无论是选择.NET Framework还是.NET Core版本，WinFormium都能完美支持。

第二步：安装核心NuGet包

通过NuGet包管理器安装WinFormium的核心组件：

Install-Package NetDimension.NanUI Install-Package NetDimension.NanUI.Runtime

对于.NET Framework项目，可能还需要安装以下预览版依赖：

Install-Package SharpGen.Runtime -Version 2.1.2-beta Install-Package SharpGen.Runtime.COM -Version 2.1.2-beta

第三步：配置应用启动入口

修改Program.cs文件，设置WinFormium应用的启动配置：

using WinFormium; class Program { [STAThread] static void Main() { var appBuilder = WinFormiumApp.CreateBuilder(); appBuilder.UseWinFormiumApp<MyApplication>(); var app = appBuilder.Build(); app.Run(); } }

创建应用配置类

新建MyApplication.cs文件，继承WinFormiumStartup基类，配置应用初始化流程：

using WinFormium; class MyApplication : WinFormiumStartup { protected override MainWindowCreationAction? UseMainWindow(MainWindowOptions options) { return options.UseMainFormium<MainWindow>(); } protected override void WinFormiumMain(string[] args) { ApplicationConfiguration.Initialize(); } protected override void ConfigurationChromiumEmbedded(ChromiumEnvironmentBuiler builder) { // 在此处配置CEF环境参数 } protected override void ConfigureServices(IServiceCollection services) { // 配置依赖注入服务 } }

设计现代化应用窗口

新建MainWindow.cs文件，创建继承自Formium的主窗口类：

using WinFormium; using WinFormium.Forms; class MainWindow : Formium { public MainWindow() { Url = "https://cn.bing.com"; // 设置首页地址 } protected override FormStyle ConfigureWindowStyle(WindowStyleBuilder builder) { var style = builder.UseSystemForm(); style.TitleBar = false; // 禁用系统标题栏 style.DefaultAppTitle = "我的首个HTML5桌面应用"; return style; } }

运行与效果验证

完成配置后，编译并运行项目，你将看到：

• 一个显示必应搜索页面的现代化窗口
• 无传统标题栏的简洁界面设计
• 可通过拖动边框调整窗口尺寸

核心概念快速理解

Formium类：WinFormium框架的核心组件，代表一个能够加载和显示网页内容的窗口，继承自Windows窗体的Form基类。

自定义窗口样式：通过设置TitleBar = false，你可以完全控制窗口的外观和行为，为UI设计提供无限可能。

常见配置问题

Q: 如何为自定义窗口添加控制按钮？ A: 可以通过HTML/CSS设计界面元素，然后使用JavaScript与C#代码进行交互。

Q: 如何配置CEF运行时参数？ A: 在ConfigurationChromiumEmbedded方法中设置缓存路径、GPU加速等选项。

进阶学习路径

1. 掌握自定义标题栏和控制按钮的实现
2. 学习C#与JavaScript的双向通信机制
3. 了解应用打包和分发的最佳实践

通过这个快速入门指南，你已经成功创建了一个基础的WinFormium应用程序。WinFormium的强大之处在于它将Web技术的灵活性与Windows桌面应用的稳定性完美结合，为现代桌面应用开发开辟了新的道路。

【免费下载链接】NanUINanUI is an open source .NET project for .NET developers who want to create desktop applications with HTML, CSS and JavaScript.项目地址: https://gitcode.com/gh_mirrors/na/NanUI