CAD_vba开发手册

VBA开发人员手册姓名：高化奎深圳爱华勘测工程有限公司第一章：VBA入门本章将为你介绍AutoCADVBA工程及VBA交互开发环境(VBAIDE)。尽管大部分VBA环境在行为上都是相似的，但AutoCADVBAIDE还是有些独有的特性。在AutoCAD中还有些相关的命令可以用于装载工程、运行工程，或打开VBAIDE环境。本章将概要介绍VBA工程、VBA命令和VBAIDE的使用。本章具体内容如下：了解嵌入和全局VBA工程、用VBA管理器组织工程、处理宏、用VBAIDE编辑工程、更多的信息、回顾AutoCADVBA工程术语、回顾AutoCADVBA命令第一节：了解嵌入和全局VBA工程AutoCADVBA工程是代码模块、类模块和窗体的集合，它们组合起来以执行给予的功能。工程可保存在AutoCAD图形中，或作为独立的文件保存。嵌入工程是保存在AutoCAD图形中。当包含有这些工程的图形中AutoCAD打开时，他们可以自动地装载，这种方法可以很方便地分发工程给用户。嵌入工程也有它的极限，它不能打开或关闭AutoCAD图形，那是由于他们的函数只存在于工程所在的文档中。使用嵌入工程不需要在运行程序之前查找并装载工程文件。举个含有嵌入工程的图形的例子，当图形打开时，一个时间日志被触发。通过这样一个宏的应用可以登记并记录用户在该图形上所花费的时间。这时用户不必去记住在打开图形之前装载工程，这就是自动操作的一个很好的例子。全局工程保存在独立的文件中，它更加通用，因为他们能在AutoCAD图形中运行，也能打开、关闭AutoCAD图形，但它在图形打开时不能自动装载。用户必须知道他们所需要的宏包含在哪个工程文件中。然而，全局工程非常容易与其它使用者共享，它可以将通用的宏做为很好的库而存在。举个例子，你保存在一个工程文件中的宏是有关多个图形的材料清单。这个宏可以在工作周期的末期由管理员运行，这样就可以收集到所有图形的信息。在特定的时间，用户可以在同个AutoCAD进程中同时装载嵌入工程和全局工程。AutoCADVBA工程与VisualBasic工程在二进制结构上是不兼容的。然而，其中的窗体、模块和类可以通过在VBAIDE环境中使用输入和输出VBA命令来在工程之间进行转换。关于VBAIDE的更多信息，可以查看“用VBAIDE编辑工程”第二节：用VBA管理器组织工程你可以使用VBA管理器查看装载在当前AutoCAD进程的所有VBA工程。VBA管理器一个AutoCAD工具，它允许你装载、卸载、保存、创建、嵌入和分离VBA工程。打开VBA管理器的步骤：1.在工具菜单中选择宏-VBA管理器。2.或者，在AutoCAD中调用VBAMAN命令。本节的内容：装载现存的工程、卸载工程、嵌入工程到图形中、从图形中分离工程、创建新的工程、保存嵌入工程。装载现存的工程当你装载工程到AutoCAD中，所有的公用的子程序(也称为宏)都可以使用。嵌入于图形中的工程在图形打开时就被装载。保存在DVB文件中的工程必须单独装载。装载现存的VBA工程文件1.在VBA管理器中，使用装载项可弹出打开VBA工程对话框。2.在打开VBA工程对话框中，选择打开的工程文件。该VBA工程对话框允许你打开有效的DVB文件。如果你尝试打开不同类型的文件，你将会得到出错信息。3.选择打开。你也可以使用VBALOAD命令直接出现打开VBA工程对话框以装载工程文件。另外，当工程装载后，该工程所引用的其它工程将会自动地装载。还有，AutoCAD在启动时将自动装载名称为acad.dvb的工程文件。相关主题：病毒警告每次当你装载工程时，你会看到启用或禁用工程中的代码以阻止宏病毒的警告框。如果你选用启用代码，如果工程中含有宏病毒时病毒可能会发作。如果你禁用代码，工程同样会装载，但工程中的所有代码将不能运行。想查看更多关于病毒保护的信息，请参考“设置工程选项”。卸载工程卸载工程以释放内存并保持装载的工程列表的长度以方便管理。你不能卸载嵌入工程或由其它已装载工程所引用的工程。卸载VBA工程的操作1.在VBA管理器中，选择要卸载的工程。2.选择卸载。或者，使用VBAUNLOAD命令，它将提示你所要卸载的工程。嵌入工程到图形中当你嵌入一个工程时，你是将工程的一个副本置于图形数据库中。无论何时，当所包含工程的图形打开或关闭时，工程会同时被装载和被卸载。一个图形只有在同一时间包含一个嵌入工程。如果图形已经包含有一个嵌入工程，你必须在同样地入其它工程之前将该嵌入工程分离出。嵌入工程到AutoCAD图形中的操作。1.打开VBA管理器并选择你所要嵌入的工程。2.选择嵌入。从图形中分离工程当你分离工程时，其实是将工程从图形数据库中删除，同时会提示你将工程保存为外部的工程文件。如果你没有将其保存为外部工程文件，该工程的数据将会删除。从AutoCAD图形中分离工程的操作1.打开VBA管理器并选择要从图形中分离的工程。2.选择分离。3.如果你想保存工程信息为外部工程文件，可以在“你是否想在删除VBA工程前将其输出？”的提示下选择“是”，此时会显示另存为对话框，允许你保存文件。如果你不想保存该工程信息到外部文件，可以在“你是否想在删除VBA工程前将其输出？”的提示下选择“否”，此时工程信息将在没有保存的情况下从图形中删除。创建新的工程新的工程将作为未保存的全局工程被创建。当工程创建时，你可以将工程嵌入图形中，或将其保存为工程文件。创建新的VBA工程的操作1.打开VBA管理器。2.选择新建。新创建的工程将使用默认的工程名称ACADproject。你必须到VBAIDE中才可以更改工程名称。查看更多关于命名工程的信息，请参考“命名工程”。保存嵌入工程嵌入工程是在图形保存时同时保存的。全局工程必须使用VBA管理器或VBAIDE进行保存。使用VBA管理器保存工程的操作1.打开VBA管理器并选择要保存的工程。2.选择另存为，此时另存为对话框打开。3.选择用于保存工程的文件。4.选择保存第三节：处理宏与设置VBA工程选项一样，宏对话框允许你运行、编辑、删除和创建宏。宏是公用(可执行)的子程序。每一工程通常至少一个宏。打开宏对话框的操作1.从工具菜单中选择宏-宏。2.或在AutoCAD中调用VBARUN命令。在对话框中显示的是所有在有效范围内的宏名称。你可通过下拉列表来改变有效范围。该列表指定所要显示的宏所在的工程或图形。你可在以下列表内容选择所要显示宏范围所有图形和工程所有图形所有工程在当前所打开的单独图形在当前所装载的单独工程通过限制有效范围你可控制显示在列表中的宏名称的数量。它可帮助你注意到当前有多少宏装载到图形中或指定工程中有多少宏。本节内容：运行宏编辑宏逐语句运行宏创建新的宏删除宏设置工程选项运行宏运行宏就是在当前AutoCAD进程中执行宏代码。当前活动图形指的是当宏执行开始时处于打开并处理激活状态。所有在全局工程的宏中所涉及的ThisDrawing对象将指向当前活动图形。在嵌入工程中，ThisDrawing对象通常指向嵌入该宏的图形。运行宏的操作1.打开宏对话框并选择要运行的宏。2.选择运行。编辑宏编辑宏将打开VBAIDE并打开所选定宏的代码窗口。详细的介绍请参考“用VBAIDE编辑工程”。编辑宏的操作1.打开宏对话框并选择要编辑的宏。2.选择编辑。逐语句运行宏逐语句运行宏指的是开始运行宏并在第一行代码时暂停。VBAIDE也随之打开所选定的宏的代码窗口并高亮显示所执行宏所在的行。逐语句运行宏的操作1.在宏对话框中，选择要逐语句运行的宏。2.选择逐语句。创建新的宏你可以创建一个空的新宏。创建新宏的操作1.打开宏对话框并输入新宏的名称。2.在宏位置下拉列表中选择所创建宏所要存在的位置。3.选择创建。如果所指定宏的名称已经存在，系统将提示你是否替换现在的宏。如果你在提示下选择“是”，则现在的宏代码将被删除，而一个新的而没有内容的宏也会以指定名称而创建。如果你在提示下选择“否”，这时会返回宏对话框以输入另外的宏名称。如果你在提示下选择“取消”，宏对话框将消失，宏也没有创建。删除宏你可以从工程中删除宏删除宏的操作1.打开宏对话框并选择要删除的宏2.选择删除。系统会提示你是否确认删除。3.在提示下，选择“是”而删除宏，或者选择“否”以取消删除的操作。设置工程选项在AutoCADVBA工程中可以设置三个选项：启用自动嵌入出错时允许中断启用宏病毒保护设置AutoCADVBA工程选项的操作1.从工具菜单中选择宏-宏以打开VBA宏对话框。2.从VBA宏对话框中，选择选项以打开选项对话框。3.从选项对话框中，选择你所要设置的选项。4.选择确定。本节内容：启用自动嵌入出错时允许中断启用宏病毒保护启用自动嵌入自动嵌入特性将在打开图形时自动为所有图形创建嵌入的VBA工程。出错时允许中断在遇到错误时允许VBA进入中断模式。中断模式是在交互开发环境中暂时挂起程序的执行。在中断模式中，你可以检查、调试、复位、跳过或继续程序的执行。当该选项启用时，在执行VBA宏的过程中如发现的未处理的错误，将会挂起执行的宏并在VBAIDE中显示宏的出错点。当该选项禁用时，当执行VBA宏的过程中如发现出错时，将出现错误警告提示框，然后结束宏的执行。启用宏病毒保护病毒防护机制将在你打开可能含有宏病毒的图形时显示内建的警告信息。第四节：用VBAIDE编辑工程当工程装载到AutoCAD后，你可以使用VBA交互开发环境编辑其代码、窗体及进行引用。你也可以在VBAIDE中调试和运行工程。本节内容：打开VBAIDE查看工程信息定义工程的部件输入现存的部件编辑部件运行宏命名工程保存工程引用其它VBA工程设置VBAIDE选项打开VBAIDE当打开VBAIDE时，它就可以访问所有已装载的工程。按需要打开VBAIDE的操作:你可以从命令行或从菜单栏中打开VBAIDE从命令行，可输入VBAIDE，或从工具菜单，使用宏-VisualBasic编辑器。在AutoCAD启动时自动打开VBAIDE的操作：如果你想在每次开始AutoCAD时自动打开VBAIDE，你必须在acad.rx文件中包含以下行：acadvba.arx查看工程信息VBAIDE包含名称为工程窗口的窗口，其中显示了所有已装载VBA工程的列表。它也显示包含在工程中的代码、类和窗体模块，还有关联到该工程的文档，在该工程所引用的VBA工程，以及工程的物理位置(也称路径)。工程窗口有它自己的工具栏，使用其工具栏可打开不同的工程部件进行编辑。使用查看代码按钮可打开选定模块的代码。使用查看对象按钮可显示如窗体之类的选定对象。VBAIDE工程窗口工程窗口默认为可见。如果不可见，可从查看菜单中选择工程窗口，或按CTRL+R。定义工程的部件每个工程可包含多个不同的部件。在工程中包含的不同部件可以是对象、窗体、标准模块、类模块和引用。对象对象部件声称了VBA代码可访问的对象或文档的类型。在AutoCADVBA工程，该对象声称为当前AutoCAD图形。窗体：窗体部件包含了当前你在工程中为了使用而建立的自定义对话框。标准模块：该代码部件包含了普通程序和函数。标准模块也归类为代码模块或简单的模块。类模块：类模块部件包含你所有定义为类的自己的对象。引用：引用部件包含所有引用其它的工程和库。增加新部件增加新的部件是在工程中创建一空白的部件。你可在工程中增加新的模块、窗体和类模块。你有责任更新所有部件的属性(如部件的名称)并在其中写入适当的代码。当命名一个新的部件，请记住可能其它开发都会在以后的应用程序中用到你的部件。在你的开发项目中应该跟随适当的名称约定。增加新的部件到工程的操作1.在VBAIDE的工程窗口中，选择你要增加部件的工程。2.从插入菜单中，选择用户窗体、模块或类模块以增加新的部件到你的工程中。新的模块将被增加到你的工程中并出现在工程窗口中。输入现存的部件输入功能允许你增加现存的部件到工程中。你可以输入窗体、模块或类模块。输入的窗体文件为FRM文件，输入的模块文件为BAS文件，输入的类模块文件为CLS文件。当你输入一个部件文件，文件的一个副本将输入并增加到工程中。而原来的文