【亲测有效】中望CAD二次开发入门:C++ + Qt 最小示例快速跑通
【亲测有效】中望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 三者按上表配套,混版本最常见的结果是链接失败。