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  # 句柄  # 桥接  # 的是  # 都是  # 这是  # 鼠标  # 均为  # 适用于  # 这类 

相关文章： 实例解析angularjs的filter过滤器  招商网站制作流程,网站招商广告语？  手机怎么制作网站教程步骤,手机怎么做自己的网页链接？  建站之星多图banner生成与模板自定义指南  建站之星IIS配置教程：代码生成技巧与站点搭建指南  南阳网站制作公司推荐,小学电子版试卷去哪里找资源好？  公司网站制作需要多少钱,找人做公司网站需要多少钱？  如何处理“XML格式不正确”错误 常见XML well-formed问题解决方法  建站为何优先选择香港服务器？  如何通过建站之星自助学习解决操作问题？  jQuery 常见小例汇总  微信小程序 五星评分(包括半颗星评分)实例代码  建站之星logo尺寸如何设置最合适？  建站之星与建站宝盒如何选择最佳方案？  公司网站设计制作厂家,怎么创建自己的一个网站？  武汉网站设计制作公司,武汉有哪些比较大的同城网站或论坛，就是里面都是武汉人的？  如何设置并定期更换建站之星安全管理员密码？  广州网站制作的公司,现在专门做网站的公司有没有哪几家是比较好的，性价比高，模板也多的？  宝塔面板如何快速创建新站点？  百度网页制作网站有哪些,谁能告诉我百度网站是怎么联系？  如何在IIS服务器上快速部署高效网站？  怎么制作网站设计模板图片,有电商商品详情页面的免费模板素材网站推荐吗？  如何获取开源自助建站系统免费下载链接？  建站之星伪静态规则如何正确配置？  如何选择网络建站服务器？高效建站必看指南  云南网站制作公司有哪些,云南最好的招聘网站是哪个？  公司网站建设制作费用,想建设一个属于自己的企业网站，该如何去做？  PHP 500报错的快速解决方法  专业网站建设制作报价,网页设计制作要考什么证？  免费制作海报的网站,哪位做平面的朋友告诉我用什么软件做海报比较好?ps还是cd还是ai这几个软件我都会些我是做网页的？  家具网站制作软件,家具厂怎么跑业务？  如何通过智能用户系统一键生成高效建站方案？  定制建站策划方案_专业建站与网站建设方案一站式指南  如何用5美元大硬盘VPS安全高效搭建个人网站？  建站之星ASP如何实现CMS高效搭建与安全管理？  西安专业网站制作公司有哪些,陕西省建行官方网站？  网站制作难吗安全吗,做一个网站需要多久时间？  如何在阿里云虚拟服务器快速搭建网站？  全景视频制作网站有哪些,全景图怎么做成网页？  如何快速生成可下载的建站源码工具？  建站之星后台搭建步骤解析：模板选择与产品管理实操指南  如何正确选择百度移动适配建站域名？  制作表格网站有哪些,线上表格怎么弄？  如何零成本快速生成个人自助网站？  专业型网站制作公司有哪些,我设计专业的，谁给推荐几个设计师兼职类的网站？  免费制作小说封面的网站有哪些,怎么接网站批量的封面单？  湖州网站制作公司有哪些,浙江中蓝新能源公司官网？  音乐网站服务器如何优化API响应速度？  建站主机类型有哪些？如何正确选型  广东企业建站网站优化与SEO营销核心策略指南