WinForm + Win32 API 自定义无边框窗口实战（工业软件必备）

今日新闻 2025年09月22日 22:38 0 aa

前言

随着 .NET 9.0 AOT（Ahead-of-Time）的发布，便萌生了用代码测试AOT编译效果的想法，同时评估未来是否为NanUI开发支持AOT编译的新版本。

关于NanUI项目，若大家尚未了解，可通过这篇文章进行查阅《》。这是一个基于CefSharp的WinForm框架，专为现代Web应用嵌入桌面端设计。而本文要探讨的，是一个基于Win32 API实现的WinForm无边框窗口实验项目——它既是技术验证的产物，也为NanUI未来版本优化提供了参考。

项目介绍

项目灵感源于一位国外开发用C++实现的Win32无边框窗口代码。作者将其逻辑迁移至C#，并基于WinForm框架重构。

尽管NanUI现有版本已通过继承Form类实现无边框效果，但这种方式依赖.NET运行时环境，且不同版本中存在兼容性问题（如DPI缩放、消息循环处理等）。

未来NanUI的承载窗体计划直接调用Win32 API创建，以统一窗体行为并减少依赖。而选择WinForm而非纯Win32项目，则因WinForm已封装了消息循环、DPI适配等底层逻辑，能大幅降低开发复杂度。

第三方库依赖

项目使用了MIT协议开源的Vanara库

GitHub：https://github.com/dahall/Vanara

它提供对Windows API的C，简化了原生代码调用。

项目功能

1、F1：实时切换普通窗体与无边框模式，便于对比效果。

2、F2：在无边框模式下启用/禁用DWM（Desktop Window Manager）阴影效果（兼容Win7/Win10/Win11）。

3、F3：切换窗体拖动功能，通过鼠标左键拖拽移动窗体位置。

4、F4：切换窗体缩放功能，拖拽边缘调整窗口大小。

另外，项目还尝试集成Windows 11的Mica背景特效，但受限于AOT编译兼容性问题。

项目特点

1、轻量化设计

直接调用Win32 API创建窗体，避免Form类带来的冗余功能，降低内存占用与潜在冲突风险。

2、跨平台兼容性

代码已测试通过Windows 10/11 x64系统，支持AOT编译为原生二进制文件，摆脱.NET运行时依赖。

3、动态效果调试

通过快捷键实时切换窗体属性，无需重启程序即可验证不同配置下的表现。

项目技术

1、Win32 API调用

使用CreateWindowEx创建无边框窗体，通过WS_EX_LAYERED等扩展样式控制透明度与层叠。

调用DwmSetWindowAttribute设置DWM属性，实现阴影与Mica特效。

通过WM_NCHITTEST消息重写窗体非客户区行为，支持自定义拖拽与缩放。

2、WinForm集成

继承 NativeWindow 类封装原生窗体句柄，复用WinForm的事件处理机制。利用 Application.Run 启动消息循环，避免手动处理 GetMessage 等底层逻辑。

3、AOT编译适配

配置.csproj文件启用PublishAot标志，生成独立可执行文件。

测试发现DwmSetWindowAttribute在AOT模式下会导致崩溃，推测为Vanara库的反射调用不兼容。

项目说明

代码结构如下

/BorderlessWindowDemo  
  ├── MainForm.cs         # 主窗体逻辑与快捷键处理  
  ├── NativeMethods.cs    # Win32 API声明与封装  
  ├── Program.cs # AOT编译配置入口  
  └── BorderlessWindow.cs # 无边框窗体核心实现

关键代码片段（窗体创建与消息处理）：

// 创建无边框窗体  
protected override void OnHandleCreated(EventArgs e) {  
    base.OnHandleCreated(e);  
    var style = WS_POPUP | WS_VISIBLE;  
    var exStyle = WS_EX_LAYERED | WS_EX_TOOLWINDOW;  
    SetWindowLong(this.Handle, GWL_STYLE, (int)style);  
    SetWindowLong(this.Handle, GWL_EXSTYLE, (int)exStyle);  
}  

// 处理鼠标拖拽  
protected override void WndProc(ref Message m) {  
    constint WM_NCHITTEST = 0x0084;  
    constint HTCLIENT = 1;  
    constint HTCAPTION = 2;  

    if (m.Msg == WM_NCHITTEST && _canDrag) {  
        m.Result = (IntPtr)(HTCAPTION);  
        return;  
    }  
    base.WndProc(ref m);  
}