【亲测有效】中望CAD二次开发入门:C++ + Qt 最小示例快速跑通

原创2026-11-15 16:18:071,435 阅读

【亲测有效】中望CAD二次开发入门:C++ + Qt 最小示例快速跑通

中望CAD二次开发示例CQT界面 是一个用 C++ 配合 Qt 编写的最小中望CAD插件工程:编译出 .zrx 插件后加载到中望CAD 2022,就能弹出一个 Qt 对话框,并演示如何读取图形对象的扩展字典。第一次接触 ZWCAD 插件开发、想弄清 C++ Qt 二次开发里界面与图纸数据怎么联动的人,可以直接照着走一遍。

什么场景下用得上

  • 你想在图纸对象上挂自定义数据,再让插件完成 CAD 扩展字典读取,把数据展示出来或据此执行操作;
  • 你想要一个带按钮、输入框的图形界面,而不是只在命令行里敲文字;
  • 你想评估用 C++ 写中望CAD插件的成本,或参考它的思路把插件移植到其他 CAD 平台。

环境版本怎么配

示例锁定了一套版本组合,建议照着装,少踩链接和配置上的坑:

组件 版本
编译器 Visual Studio 2015
Qt 5.12.9(qt-opensource-windows-x86-5.12.9.exe)
Qt 辅助工具 Qt Visual Studio Tools 2.7.2 (rev.2)
CAD ZWCAD 2022 简体中文

安装顺序:先装 VS2015,再装 Qt 5.12.9,最后在 VS 里装 Qt Visual Studio Tools。原因很直接:工程文件就是按这套组合生成的,Qt 路径和链接参数都对准了这些版本。

从克隆仓库到第一次加载插件

先克隆仓库:git clone https://gitcode.com/open-source-toolkit/ba061

再解开工程包:源码在 ZwHelloWorld.zip,解压到本地任意目录。包内是 Samples.sln 解决方案和两个工程:HelloWorld/ 是插件主体,QtClassLibrary1/ 是 Qt 对话框工程,界面布局见 QtWidgetsClass.ui。

然后在 VS2015 中打开 Samples.sln,在 Qt VS Tools 的设置里指向 Qt 5.12.9 的安装目录,选 Release 配置编译。

最后在 ZWCAD 2022 里用 APPLOAD 命令加载编译出的 HelloWorld.zrx,运行插件注册的命令:预期会弹出一个 Qt 对话框;图纸对象上若挂了扩展字典数据,插件会把它读出来。

两个核心能力各解决什么问题

Qt 对话框:把命令行交互变成点击

CAD 命令行只能回显文本,QtClassLibrary1/ 这个工程给你一套图形界面:参数输入、结果显示、按钮触发都放在对话框里。实际效果是,用户点一下按钮就能完成原本要敲命令的操作,报错也更直观。

读取扩展字典:图纸自带的数据通道

扩展字典是 CAD 数据库给图形对象挂自定义键值数据的机制。插件读取它之后能做的事很具体:在对话框里显示图纸元信息、按数据值走不同分支、批量处理带标记的对象。它是图纸与插件之间传递自定义数据的基础。

迁移 AutoCAD 要注意什么

代码可以迁移到 AutoCAD,但不要期待开箱即用:

  • 把工程引用的中望 SDK 头文件和库换成 AutoCAD ObjectARX 对应版本,重新编译;
  • 中望 SDK 与 AutoCAD ObjectARX 在个别 API 签名和行为上可能有差异,命令注册、数据库读写要逐条验证;
  • 产物与加载入口不同:中望侧加载 .zrx,AutoCAD 侧对应 .arx,文件名和加载方式都要跟着调整。

常见坑与项目信息

⚠️ 三个高频问题:

  • Qt 运行库要跟着插件走:x64/Release/ 里已附带 Qt5Core、Qt5Gui、Qt5Widgets 等运行库,部署时把 .zrx 和这些 DLL 放在同一目录,否则加载后弹窗会失败;
  • 位数要一致:示例产物在 x64 目录下,32 位 CAD 加载不了,确认你的 ZWCAD 是 64 位;
  • 版本混搭:Qt、Qt VS Tools、VS 三者按上表配套,混版本最常见的结果是链接失败。

项目采用 MIT 许可,见 LICENSE;有改进想法可以直接提 PR 或建议,更多说明参考 README.md。

登录后查看全文
中望CAD二次开发示例CQT界面