Avalonia如何嵌入原生控件 Avalonia Native Controls

Avalonia不提供原生控件库，所有标准控件均为Skia自绘；嵌入原生控件需用NativeControlHost，支持WinForms、Gtk、Cocoa等平台句柄，但需手动处理生命周期、尺寸同步及事件桥接。

Avalonia 本身不提供“原生控件库”意义上的 Avalonia Native Controls（即一套由操作系统直接渲染、非 Avalonia 自绘的 Win32/WPF/Gtk 原生控件集合），它走的是自绘（skia-based）路线，所有标准控件（Button、TextBox 等）都是 Avalonia 自己实现并跨平台一致渲染的。

真正能嵌入原生控件的方式是 NativeControlHost

若你确实需要在 Avalonia 界面中显示平台专属的原生控件（如 WinForms Control、WPF Element、或 Linux 下的 Gtk Widget），核心方案是使用：

• NativeControlHost 控件：Avalonia 官方提供的宿主容器，专用于承载各平台原生句柄（HWND、GtkWidget、NSView 等）
• 它不渲染内容，只负责生命周期管理、尺寸同步和基本消息转发
• 需手动创建原生控件，并将其平台句柄（如 WinForms.Control.Handle）赋给 NativeControlHost.Child 或通过 IPlatformHandle 封装后设置

WinForms 嵌入典型流程（Windows）

这是最常见场景，适用于渐进式迁移：

• 在 Avalonia XAML 中放置：
• C# 中新建 WinForms 控件（如 new Panel() 或自定义 UserControl）
• 调用 Control.CreateControl() 获取其 HWND，并封装为 IPlatformHandle
• 将该 handle 赋值给 host.Child = new PlatformHandle(hwnd, "HWND")
• 注意：WinForms 控件需在 UI 线程创建，且不能启用双缓冲冲突（可能需关闭 DoubleBuffered）

其他平台原生控件嵌入要点

Linux（Gtk）和 macOS（Cocoa）同样支持，但方式不同：

• Linux 下常用 Gtk.Socket + XEmbed 协议嵌入外部 Gtk 应用窗口（见 XEmbedSample 示例）
• macOS 需桥接 NSView，通过 PlatformHandle 传入 IntPtr 句柄及类型标识（如 "NSView"）
• 所有平台都依赖 Avalonia.Native 底层对原生窗口系统的适配能力
• 事件同步（如鼠标、键盘）需额外处理：Avalonia 的 InputManager 可接管，但焦点/输入法可能需手动桥接（例如 CefGlue 场景中需实现 TextInputMethodClient）

别混淆：Semi.Avalonia 不是“原生控件”

像 Semi.Avalonia 这类第三方控件库，仍是基于 Avalonia 自绘体系构建的纯托管控件，样式美观、扩展性强，但并非操作系统原生控件。它只是 Avalonia 生态的增强，不是 NativeControlHost 的替代方案。

# linux  # windows  # 操作系统  # mac  # macos  # win  # c#  # cos  # red  # 封装  # 线程  # 事件  # cocoa  # wpf  # ui  # 句柄  # 桥接  # 的是  # 都是  # 这是  # 鼠标  # 均为  # 适用于  # 这类 

相关文章： 如何在阿里云高效完成企业建站全流程？  如何在景安服务器上快速搭建个人网站？  长春网站建设制作公司,长春的网络公司怎么样主要是能做网站的？  桂林网站制作公司有哪些,桂林马拉松怎么报名？  如何在橙子建站中快速调整背景颜色？  如何用虚拟主机快速搭建网站？详细步骤解析  如何零基础在云服务器搭建WordPress站点？  如何在VPS电脑上快速搭建网站？  矢量图网站制作软件,用千图网的一张矢量图做公司app首页，该网站并未说明版权等问题，这样做算不算侵权？应该如何解决？  如何选择高效便捷的WAP商城建站系统？  如何获取上海专业网站定制建站电话？  详解一款开源免费的.NET文档操作组件DocX（.NET组件介绍之一）  ,有什么在线背英语单词效率比较高的网站？  深圳网站制作公司好吗,在深圳找工作哪个网站最好啊？  平台云上自助建站如何快速打造专业网站？  php条件判断怎么写_ifelse和switchcase的使用区别【对比】  已有域名和空间，如何快速搭建网站？  专业的网站制作设计是什么,如何制作一个企业网站，建设网站的基本步骤有哪些？  广东企业建站网站优化与SEO营销核心策略指南  建站之星免费模板：自助建站系统与智能响应式一键生成  网站制作的软件有哪些,制作微信公众号除了秀米还有哪些比较好用的平台？    制作网站怎么制作,*游戏网站怎么搭建？  如何在香港免费服务器上快速搭建网站？  沈阳个人网站制作公司,哪个网站能考到沈阳事业编招聘的信息？  手机网站制作与建设方案,手机网站如何建设？  如何高效搭建专业期货交易平台网站？  如何制作一个表白网站视频,关于勇敢表白的小标题？  Swift中switch语句区间和元组模式匹配  如何自己制作一个网站链接,如何制作一个企业网站，建设网站的基本步骤有哪些？  孙琪峥织梦建站教程如何优化数据库安全？  如何快速搭建响应式可视化网站？  网站制作培训多少钱一个月,网站优化seo培训课程有哪些？  Python lxml的etree和ElementTree有什么区别  香港代理服务器配置指南：高匿IP选择、跨境加速与SEO优化技巧  建站OpenVZ教程与优化策略：配置指南与性能提升  网站制作大概要多少钱一个,做一个平台网站大概多少钱？  如何用PHP快速搭建高效网站？分步指南  在线ppt制作网站有哪些软件,如何把网页的内容做成ppt？  建站之星ASP如何实现CMS高效搭建与安全管理？  Bpmn 2.0的XML文件怎么画流程图  小自动建站系统：AI智能生成+拖拽模板，多端适配一键搭建  如何快速搭建自助建站会员专属系统？  mc皮肤壁纸制作器,苹果平板怎么设置自己想要的壁纸我的世界？  网站制作与设计教程,如何制作一个企业网站，建设网站的基本步骤有哪些？  专业网站制作服务公司,有哪些网站可以免费发布招聘信息？  C++时间戳转换成日期时间的步骤和示例代码  外贸公司网站制作,外贸网站建设一般有哪些步骤？  网站设计制作公司地址,网站建设比较好的公司都有哪些？  建站之星logo尺寸如何设置最合适？