【转载】使用ObjectARX 2005+Visual Studio.NET 2003创建ARX程序

使用ObjectARX进行AutoCAD的开发，第一步当然是环境的配置啦。ObjectARX在2006之前都大量使用了VC++ 7.0的技术，使用它，最好是搭配Visual Studio 2002。但VS2002已经很难找到，相比之下VS2003在网络比较多见。下文就是介绍如何使用ObjectARX2005＋Visual Studio.NET 2003搭建开发环境的：

我是在一个偶然的机会接触到
ARX的，其实原来对于CAD的二次开发接触并不多，这方面的积累也不够充分，但既然已经涉及到这个领域，那么就希望学到这个领域最领先的知识。在翻阅了
一些前辈的大作、浏览了很多网页后发现ARX的强大功能是大家公认的，但是由于开发人员的稀缺和软件的更新换代，ARX的学习资料不是很多，特别是在.
net平台下开发ARX的资料就更少了。下面的文章中我将给大家讲讲ARX入门的经验，希望大家少走弯路，有经验大家可以一起交流。

相信大家已经拜读过金建承老师的文章《为什么要学ARX》，对ARX已经有所了解，那么接下来的问题就是怎样学好ARX。明经通道中有相关的文章，但总归
是几年以前的，现在大家已经逐渐接受在.net平台下开发，那些文章总让人觉得不合时宜。下面的文章中假定你毫无ARX开发经验，我们将按惯例一步步的推
进。

一、基础知识

使用ARX在.net平台下开发首先应该具备C++和AutoCAD的基础知识，如果不会可以现学，反正这方面的资料很多，折腾一段时间拿下应该不成问题。

二、下载软件包

必备软件是ObjectARX 和.net平台，当然为了能运行编译出来的.arx文件还需要AutoCAD平台。ObjectARX软件包可以在http://www.autodesk.com/objectarx
免费下载，.net平台和AutoCAD平台就需要自备了。我选用的版本是ObjectARX 2005+Visual Studio.NET
2003，可以说是现在最新版本的组合。ObjectARX软件包和.net平台经常会出现不兼容的情形，据说Autodesk公司已经作出了改进，但我
在安装和编译过程中还是遇到了不少问题。ObjectARX 2004和ObjectARX 2005在 Visual Studio.NET
2002下都能正常的工作，但在Visual Studio.NET 2003下却多少有些问题，ObjectARX
2004甚至都不能安装ObjectARX Wizard（.msi文件），ObjectARX
2005可以安装，但编译的时候会存在问题。分析其原因是因为在ObjectARX 软件包中会调用或是验证大量VC7.0的库，而Visual
Studio.NET 2003的VC版本是7.1，因而会存在问题，Visual Studio.NET
2002的VC版本是7.0，所以可以顺利使用。我机器上装的是Visual Studio.NET
2003，没有办法，这个系统太庞大了，总不能把它卸了，再重装Visual Studio.NET 2002吧！所以最后只好使用ObjectARX
2005+ Visual Studio.NET
2003，安装没问题，但在编译的时候出现有几个VC7.0的文件找不到。通过反复验证，只要把Visual Studio.NET
2003根目录下"Vc7"atlmfc"lib文件夹中所有文件名类似**71**的文件在Visual Studio.NET
2002中相应的拷贝到文件夹里就可以了。具体有以下这些：mfc70.lib
mfc70d.lib、mfc70u.lib、mfc70ud.lib、mfcs70.lib、mfcs70.pdb、mfcs70d.lib、
mfcs70d.pdb、mfcs70u.lib、mfcs70u.pdb、mfcs70ud.lib、mfcs70ud.pdb。（VC7.0的库函数包）到现在为止，软件包的安装可以告一段落了。

三、创建最简单的ARX程序

在下面的文章中我将通过一个最简单的实例来讲述ARX程序的创建过程，介绍编制Object
ARX程序的一些基本步骤和原则，并初步了解ARX程序与AutoCAD进行通讯的方式。这一节的大部分内容在Object ARX
2005自带培训教程ObjectARXLabs.chm中都有，喜欢看英文原文的朋友可以自己去下载浏览。如同学习其它计算机语言一样，我们首先来创建
一个最简单的ARX程序——“Step01.ARX”，在AutoCAD 2005中加载并运行该程序，将会在命令行出现－“Hello,
world!”。

我们首先来看看建立ARX程序的基本步骤：

由于ARX程序是一种可以共享AutoCAD地址空间并对AutoCAD进行直接调用的动态链接库，因此可以按照下列基本步骤建立ARX程序：

(1) 创建自定义类来实现新的命令：用户可以从ARX类层次关系中的大多数类和符号表类中派生自己的类。

(2) 决定ARX程序应该响应的AutoCAD消息：AutoCAD通过向ARX程序发出一系列的消息指明在它内部发生的特殊事件，ARX程序必须对其中的某些消息作出反映，并触发相应的操作。

(3)
实现应用程序与AutoCAD通信的入口：AutoCAD通过函数acrxEntryPoint()来调用ARX程序，而不是象普通的C++程序那样使用
main()函数。函数acrxEntryPoint()中可以用switch语句处理AutoCAD的各种返回信息，根据不同信息执行不同的函数，并返
回状态码。如果针对特定的消息返回出错代码，则必须用case语句来处理。最后，必须用AcRx::kRetOk作为函数acrxEntryPoint
()的最终返回值。

(4)
完成ARX程序的初始化：用户必须在acrxEntryPoint()函数的AcRx::kInitAppMsg事件中或者该事件调用的函数（例如：
initApp（）函数）中，对程序中自定义的所有类进行初始化，然后调用acedRegCmds->addCommand()函数在
AutoCAD命令堆栈中注册新命令。

(5)
实现卸载（Unload）功能：用户必须在acrxEntryPoint()函数的AcRx::
kUnloadAppMsg事件中或者该事件调用的函数（例如：unloadApp（）函数）中，调用acedRegCmds->
removeGroup()函数将initApp（）函数中注册的新命令组从AutoCAD命令堆栈中清除，调用deleteAcRxClass()函数
清除程序中自定义的任何类，然后删除所有由应用程序添加到AutoCAD中的对象，并清除所有与AcDbObject、AcDbDatabase、
AcRxDynamicLinker或AcEditor对象相关联的事件反应器。

注意
缺省情况下，ARX程序处于被锁定状态而不能被卸载，如果要使ARX程序可以被卸载，需保存由AcRx::kInitAppMsg传送的appId参数，
由unlockApplication()函数调用，见acrxEntryPoint ()函数注释。

我们还需要了解AutoCAD与ARX程序之间的消息传递，AutoCAD向ARX程序发送四类消息：

(1) 发送给所有ARX程序的消息：kInitAppMsg、kUnloadAppMsg、kLoadDwgMsg、kPreQuitMsg。

(2) 只发送给通过调用acedDefun() 函数注册AutoLISP函数的ARX程序的消息：kUnloadDwgMsg、kInvkSubrMsg、kEndMsg、kQuitMsg、kSaveMsgkCfgMsg。

(3) 只发送给注册service对象的ARX程序的消息：kDependencyMsg、kNoDependencyMsg。

(4) 只发送给使用ActiveX控件对象的ARX程序的消息：kOleUnloadAppMsg。

普通的ARX程序仅需要响应消息kInitAppMsg和kUnloadAppMsg，这两种消息的含义和ARX程序对它们的响应方式为：

(1) 消息kInitAppMsg：当AutoCAD
加载ObjectARX应用程序并开始进行与应用程序的通信时发送此消息。对于此消息，ARX程序应该注册服务对象、类、AcEd命令和事件反应器，以及
AcRxDynamicLinker类事件反应器，初始化应用程序的系统资源（如设备、窗口），并执行简单的初始化操作；这时，AcRx、AcEd和
AcGe类库都应该被激活；如果需要对应用程序进行解锁或重新加锁操作，还应该保存pkt参数。但是这里不能进行下列操作：初始化设备驱动程序、激活用户
界面资源、按特殊顺序加载应用程序、执行AutoLISP程序以及打开任何数据库，否则将导致错误发生或者系统崩溃；AcDb和AcGi类库也不能在这里
激活，尽管它们与AcRx 和其它结构有联系。

(2)
消息kUnloadAppMsg：当ObjectARX程序被卸载时（由用户卸载或者AutoCAD程序终止时），AutoCAD发送此消息，关闭当前文
件并执行清除操作。对于此消息，ARX程序应该清除所有系统资源，所有对kInitAppMsg消息所做的初始化等工作都应该在这里被终止或者析构。
AutoCAD不会自动解除初始化所做的工作。

下面我们将看到怎样在.NET环境下建立一个ObjectARX工程，并创建第一个ARX程序——“Step01.ARX”。

第一步： 创建工程

(1) 运行Visual Studio.NET，选择菜单命令New->Project….，弹出“Project”对话框。

//添加ObjectARX头文件

#include "stdafx.h"

#include <aced.h>

#include <rxregsvc.h>

//声明两个函数：initApp()和unloadApp()一个作为AutoCAD调用时的初始化函数，另一个作为卸载函数

void initApp();

void unloadApp();

//声明执行函数helloWorld()，用来在AutoCAD的命令行中打印“hello,world!”

void helloWorld();

// 初始化函数,在acrxEntryPoint()函数的kInitAppMsg事件中被调用，

//向AutoCAD命令堆栈中添加新命令组以及ACRX类层次中添加新的自定义类，

// 本实例中无自定义类，故不用初始化新类。

//addCommand函数在AutoCAD命令堆栈中注册新的命令组名“HELLOWORLD_COMMANDS”、

//通用命令名“Hello”、本地命令名“你好”和该命令的执行函数helloWorld

void initApp()

// 程序卸载函数，在acrxEntryPoint()函数的kUnloadAppMsg事件中被调用

//从AutoCAD命令堆栈清除已添加的命令以及从ACRX类层次中清除自定义类

void unloadApp()

// 执行函数，在AutoCAD中执行helloWorld命令时被调用

void helloWorld()

// ARX程序主函数，与AutoCAD通信的入口，处理AutoCAD发送的各类消息

extern "C" AcRx::AppRetCode

acrxEntryPoint(AcRx::AppMsgCode msg, void* pkt)

LIBRARY Step01

EXPORTS

acrxEntryPoint PRIVATE

acrxGetApiVersion PRIVATE

到此为止，整个“Step01.ARX”程序已经完成，在.NET环境下编译，如果是按照以上的步骤逐步进行，除了我在软件安装部分提到的，应该不会出现
什么错误。你可能会看到这样的警告信息：linker warning ：LNK4099 for the rxapi.lib and
acedapi.lib libraries during the
build.。但这没关系，我编译的时候也遇到，ObjectARXLabs.chm提到了说可以忽略。

四、在AutoCAD中调用ARX应用程序

编译完之后就可以使用生成的ARX程序了，在工程目录“Step01”文件夹的“Debug”子文件夹中有一个“Step01.arx”程序。在AutoCAD中调用ARX程序的方法有几种：

(1) 把“Step01.arx”程序拖放到AutoCAD设计窗口中，直接就可以打开。

(2) 在AutoCAD命令行中键入“ARX”命令，使用“Load”选项打开。

(3) 在AutoCAD的“工具”下拉菜单中选择“加载应用程序”来打开。

(4) 在命令行中键入“APPLOAD”命令也可打开。

我使用AutoCAD 2004和2005都试过，没有太大的区别，只是上述Autodesk公司提供的这几种调用ARX程序的方法中后两种都显示说加载失败，还没找出原因，而前两种加载时会出现不兼容的警告窗口，忽略掉就行了，没有影响。

以上是我学习ARX的一点心得，借鉴了一些前辈的经验，结合在一起，算是比较完整的ARX入门级文章了。要想对ARX有更加深入的了解还是需要看书，多看实例，这样进步应该更快一些。欢迎和我进行技术交流。