企业官网建设流程全解析

从‘Hello World’到实用插件：用Visual Studio 2019和ObjectARX 2021创建你的第一个CAD命令

当你第一次打开Visual Studio 2019中的ObjectARX项目模板时，那个空荡荡的acrxEntryPoint.cpp文件可能会让你感到无从下手。这就像站在AutoCAD庞大二次开发世界的大门前，手里拿着钥匙却不知道该怎么转动。本文将带你跨过这个门槛，从修改模板代码开始，实现一个能在AutoCAD中实际运行的"绘制红色圆形"命令，并深入讲解整个开发流程中的关键细节。

1. 项目初始化与代码改造

1.1 解剖默认项目结构

使用ObjectARX Wizard创建的项目默认包含以下核心文件：

MyFirstARX/ ├── MyFirstARX.cpp // 主入口文件 ├── MyFirstARX.def // 模块定义文件 ├── MyFirstARX.vcxproj // 项目文件 └── stdafx.h // 预编译头文件

重点查看MyFirstARX.cpp，你会发现一个基本的ARX插件骨架：

#include "stdafx.h" #include "resource.h" #include <Windows.h> extern "C" AcRx::AppRetCode acrxEntryPoint(AcRx::AppMsgCode msg, void* pkt) { switch (msg) { case AcRx::kInitAppMsg: acrxDynamicLinker->unlockApplication(pkt); acrxDynamicLinker->registerAppMDIAware(pkt); break; case AcRx::kUnloadAppMsg: break; } return AcRx::kRetOK; }

1.2 添加第一个CAD命令

让我们改造这个骨架，添加一个简单的HELLOARX命令：

// 在acrxEntryPoint函数前添加命令实现 static void HelloArxCommand() { acutPrintf(_T("\nHello, ObjectARX World!")); } // 在kInitAppMsg case中添加命令注册 case AcRx::kInitAppMsg: acrxDynamicLinker->unlockApplication(pkt); acrxDynamicLinker->registerAppMDIAware(pkt); acedRegCmds->addCommand( _T("HELLOARX_GROUP"), // 命令组名 _T("HELLOARX"), // 全局命令名 _T("HELLOARX"), // 本地化命令名 ACRX_CMD_MODAL, // 命令模式 HelloArxCommand // 回调函数 ); break; // 在kUnloadAppMsg case中添加命令清理 case AcRx::kUnloadAppMsg: acedRegCmds->removeGroup(_T("HELLOARX_GROUP")); break;

2. 编译配置与调试技巧

2.1 关键项目属性设置

在VS2019中右键项目→属性，确保以下配置：

重要路径配置：

• 包含目录：添加$(OBJECTARX_SDK_DIR)\inc
• 库目录：添加$(OBJECTARX_SDK_DIR)\lib-x64
• 附加依赖项：添加acad.lib rxapi.lib acdb24.lib acedapi.lib

2.2 调试AutoCAD加载技巧

1. 配置调试目标：

   • 项目属性→调试→命令：设置AutoCAD主程序路径（如C:\Program Files\Autodesk\AutoCAD 2021\acad.exe）
   • 工作目录：设为AutoCAD启动目录

2. 使用acutPrintf输出调试信息：

   acutPrintf(_T("\n调试信息：变量值=%d"), someValue);

3. 断点调试：

   • 在VS中设置断点
   • F5启动调试，AutoCAD会自动启动
   • 在AutoCAD中使用NETLOAD加载你的ARX文件

3. 实现实用绘图功能

3.1 创建红色圆形命令

让我们升级HELLOARX命令，实现真正的绘图功能：

static void CreateRedCircle() { // 获取用户输入 ads_point center; if (acedGetPoint(NULL, _T("\n指定圆心: "), center) != RTNORM) return; double radius; if (acedGetReal(_T("\n输入半径: "), &radius) != RTNORM) return; // 创建圆形 AcGePoint3d geCenter(center[X], center[Y], 0); AcDbCircle *pCircle = new AcDbCircle(geCenter, AcGeVector3d::kZAxis, radius); // 设置红色 AcCmColor color; color.setColorIndex(1); // 1=红色 pCircle->setColor(color); // 添加到数据库 AcDbBlockTable *pBlockTable; acdbHostApplicationServices()->workingDatabase() ->getSymbolTable(pBlockTable, AcDb::kForRead); AcDbBlockTableRecord *pBlockTableRecord; pBlockTable->getAt(ACDB_MODEL_SPACE, pBlockTableRecord, AcDb::kForWrite); pBlockTable->close(); pBlockTableRecord->appendAcDbEntity(pCircle); pBlockTableRecord->close(); pCircle->close(); acutPrintf(_T("\n已创建红色圆形!")); }

3.2 命令注册优化

改进命令注册方式，支持多命令：

struct CommandInfo { const TCHAR* globalName; const TCHAR* localName; void (*function)(); }; CommandInfo commands[] = { {_T("HELLOARX"), _T("HELLOARX"), HelloArxCommand}, {_T("REDCIRCLE"), _T("REDCIRCLE"), CreateRedCircle} }; // 在kInitAppMsg中批量注册 for (int i = 0; i < sizeof(commands)/sizeof(commands[0]); i++) { acedRegCmds->addCommand( _T("MYCOMMANDS"), commands[i].globalName, commands[i].localName, ACRX_CMD_MODAL, commands[i].function ); }

4. 高级技巧与错误处理

4.1 常见错误排查表

4.2 资源管理与异常处理

使用RAII技术管理AutoCAD数据库资源：

class DbObjectGuard { public: DbObjectGuard(AcDbObject* pObj) : m_pObj(pObj) {} ~DbObjectGuard() { if(m_pObj) m_pObj->close(); } operator AcDbObject*() { return m_pObj; } private: AcDbObject* m_pObj; }; // 使用示例 AcDbCircle* pCircle = new AcDbCircle(...); DbObjectGuard guard(pCircle); // 无需手动close，guard析构时会自动处理

4.3 性能优化技巧

1. 批量操作：使用acdbOpenAcDbObject批量打开对象
2. 事务处理：对于复杂操作，使用AcDbTransaction管理
3. 缓存重用：重复使用的对象考虑缓存机制

// 事务处理示例 AcDbTransactionManager* pTM = acdbHostApplicationServices()->workingDatabase() ->transactionManager(); AcDbTransaction* pT = pTM->startTransaction(); // 在此进行数据库操作 pTM->endTransaction();

5. 插件部署与用户交互

5.1 制作安装程序

使用Inno Setup等工具创建安装包时，注意：

1. 将ARX文件复制到AutoCAD搜索路径（如%APPDATA%\Autodesk\ApplicationPlugins）
2. 可选添加注册表项实现自动加载：

   [Registry] Root: HKCU; Subkey: "Software\Autodesk\AutoCAD\R24.0\ACAD-xxxx:804\Applications\MyFirstARX"; \ ValueType: string; ValueName: "LOADCTRLS"; ValueData: "2"; \ Flags: createvalueifdoesntexist

5.2 添加自定义界面

在Wizard创建项目时勾选MFC支持，可添加对话框资源：

// 显示模态对话框 CAcModuleResourceOverride resOverride; CMyDialog dlg; dlg.DoModal();

5.3 用户配置持久化

使用注册表或配置文件保存用户偏好：

// 写入配置 acedSetEnv("MyFirstARX", "LastRadius", "10.0"); // 读取配置 TCHAR szRadius[32]; if (acedGetEnv("MyFirstARX", "LastRadius", szRadius) == RTNORM) { double radius = _tstof(szRadius); }