ObjectARX帮助文档的.net版本(第二章）

zhf7878 发表于 2005-5-15 15:24:00

第二章 AutoCAD数据库入门

 AutoCAD数据库中存储了组成AutoCAD图形的对象和实体。本章讨论数据库的关键元素：实体，符号表和命名对象字典。

 这一章也会介绍对象ID和打开数据库对象的接口。还会给出创建实体、层和组及向数据库加入对象的例子。

AutoCAD数据库概览

 AutoCAD图形是存储在为数据库中的对象集合。数据库对象的基类是实体、符号表和字典。实体是AutoCAD图形中具有图形界面的一种特殊的数据库对象。直线、圆、文本、solid、面域、椭圆等就是实体。换句话说，实体就是用户可以在屏幕上看到并且可以操作的东西。

 符号表和字典是用来存储数据库对象的容器。这些容器对象把符号名（一个字符串）映射成一个数据库对象。每个AutoCAD数据库都包括一系列固定的符号表，每个符号表包括一种特定类型的符号表记录的实例。你不能在数据库中加入新的符号表。符号表的例子包括：层表（LayerTable，包含层表记录），块表（BlockTable，包括块表记录）。所有的AutoCAD实体都属于块表记录。

 字典提供了比符号表更通用的存储对象的容器。字典可以包含DBObject类（就是实体类的基类）或它的派生类的对象。当创建一个新的AutoCAD图形时，AutoCAD数据库会创建一个名为命名对象字典的字典。你可以在命名对象字典中创建新的字典，然后在创建的字典中加入新的数据库对象。

 下图展示了AutoCAD数据库中的主要元素。



 <?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" /><o:p></o:p>

 在AutoCAD编辑的过程中，你可以通过调用语句来获取当前图形所在的数据库：

 Application.DocumentManager.MdiActiveDocument.Database<o:p></o:p>

或者HostApplicationServices.WorkingDatabase<o:p></o:p>

 <o:p></o:p>

多个数据库<o:p></o:p>

 在一个AutoCAD进程中可以载入多个数据库。进程中的每个对象都有一个句柄和对象ID。句柄唯一标识了一个数据库中的对象，对象ID唯一标识了所有数据库中的对象。对象ID只存在于一次编辑进程中，而句柄则和图形文件一起保存。和对象ID不同的是，当多个数据库被载入到AutoCAD进程中时，句柄不一定会唯一。<o:p></o:p>

 <o:p></o:p>

获得对象ID<o:p></o:p>

 有了对象ID，你可以对实际的数据库对象进行操作。<o:p></o:p>

 你可以通过不同的方法来获得对象ID：<o:p></o:p>

l 创建一个对象并加入到数据库中。数据库会给加入的对象分配一个ID，你可以通过访问对象的OjectID属性来获得分配的ID。<o:p></o:p>

l 使用数据库接口来获得对象ID，这些对象都是在数据库创建的时候被自动创建的（例如九个固定的符号表和命名对象字典）。<o:p></o:p>

l 使用特定类的接口来获得对象ID。特定类（如符号表和字典）定义的对象会包含其它的对象。这些类提供了获得包含的对象的ID的接口。<o:p></o:p>

l 查询一个选择集。用户选择后，可以通过查询选择集来获取选中的对象ID列表。<o:p></o:p>

 <o:p></o:p>

基本的数据库对象<o:p></o:p>

在AutoCAD中创建的对象都会被加入到适合它们的容器对象中。实体被加入到块表的记录中。符号表记录被加入到对应的符号表。实体和符号表之外的其它对象被加入到命名对象字典、被其它对象拥有的对象（其实这些对象最终还是被命名对象字典所拥有）或扩展的字典中。<o:p></o:p>

数据库必须至少拥有以下的对象才可用：<o:p></o:p>

l 包括块表、层表和线型表在内的九个符号表。块表最初包含三个记录：MODEL_SPACE，两个图纸空间记录（PAPER_SPACE，PAPER_SPACE0）。这三个块表记录表示模型空间和两个系统预定义的图纸空间布局。层表最初只包含一个记录0层。线型表最初只包含CONTINUOUS线型。<o:p></o:p>

l 一个命名对象字典。当一个数据库创建后，这个字典就包含了以下四个数据库字典：组字典、多线样式字典、布局字典和打印样式命名字典。在多线样式字典中，STANDARD样式总是存在的。<o:p></o:p>

当你给Database类的构造函数的buildDefaultDrawing参数传递true时，上面介绍的这些对象会被自动创建。如果传递false，则会创建一个可以载入DWG或DXF文件的空数据库。<o:p></o:p>

 <o:p></o:p>

 <o:p></o:p>

在AutoCAD中创建对象<o:p></o:p>

这一部分向大家介绍在AutoCAD中创建直线、圆、层和组，并展示AutoCAD是怎样把这些对象加入到数据库中的。首先，假定用户使用下列命令在模型空间中创建了一条直线：<o:p></o:p>

line 4,2 10,7<o:p></o:p>

在数据库中，AutoCAD先创建了一个Line类的实例，然后把它存储在模型空间块表记录中，如下图所示：<o:p></o:p>

 <o:p></o:p>

当你首次启动AutoCAD时，数据库处于缺省状态，实体被加入到模型空间，它是AutoCAD的主空间，被用于模型几何体和图形。图纸空间是用来支持“文档”几何体和图形的。生成实体的命令（LINE，对应于这个例子）把实体加入到当前的数据库中，并把它加入到模型空间块中。你可以查询实体所属的数据库和块。<o:p></o:p>

接下来，假定用户用下面的命令创建了一个圆：<o:p></o:p>

circle 9,3 2

<o:p></o:p>

同样地，AutoCAD创建了对应实体（这次是Circle）的实例，然后把它加入到模型空间块表记录中。

<o:p></o:p>

<o:p></o:p>

接下来，用户创建了一个新层：<o:p></o:p>

layer _make mylayer<o:p></o:p>

 AutoCAD创建了一个新的层表记录来表示这个层，然后把这个记录加入到层表中。<o:p></o:p>

 <o:p></o:p>

<o:p></o:p>

最后，用户把所有的实体组合在一起。<o:p></o:p>

group 3,2 9,3<o:p></o:p>

AutoCAD创建一个新的组对象，然后把它加入到组字典中，组字典包含在命名对象字典中。这个新的组包括组成这个组的对象的ID。<o:p></o:p>

<o:p></o:p>

<o:p></o:p>

<o:p></o:p>

<o:p></o:p>

<o:p></o:p>

<o:p></o:p>

<o:p></o:p>

<o:p></o:p>

 <o:p></o:p>

 <o:p></o:p>

 <o:p></o:p>

在ObjectARX中创建对象<o:p></o:p>

这部分的ObjectARX代码示例向你演示如何创建一些AutoCAD实体（直线和圆）、创建一个新层、改变直线的颜色、加入一个组到组字典中。<o:p></o:p>

 <o:p></o:p>

 <o:p></o:p>

创建实体<o:p></o:p>

下面的CreateLine()函数创建一条直线并把它加入到模型空间块表记录中：<o:p></o:p>

public void CreateLine()<o:p></o:p>

{<o:p></o:p>

 Point3d startPoint=new Point3d(4,2,0);<o:p></o:p>

 Point3d endPoint=new Point3d(10,7,0);<o:p></o:p>

 Lines line=new Lines(startPoint,endPoint);<o:p></o:p>

 Database db= Application.DocumentManager.MdiActiveDocument.Database;<o:p></o:p>

 ObjectId btID=db.BlockTableId;<o:p></o:p>

 BlockTable bt=(BlockTable)btID.Open(OpenMode.ForRead);<o:p></o:p>

 ObjectId btrID=bt;<o:p></o:p>

 BlockTableRecord btr=(BlockTableRecord)btrID.Open(OpenMode.ForWrite);<o:p></o:p>

 bt.Close();<o:p></o:p>

 btr.AppendEntity(line);<o:p></o:p>

 btr.Close();<o:p></o:p>

 line.Close();<o:p></o:p>

}<o:p></o:p>

CreateLine()首先获取当前图形的块表，然后打开模型空间块表记录用于写入。关闭块表后，向块表记录中加入实体，最后关闭块表记录和实体。<o:p></o:p>

注意：当你使用完ObjectARX对象后，你必须尽快地显式关闭它们。呵呵，就好像要大家节约用水一样，用完水以后要记得关上水龙头。不过你可能注意到在你编译这个程序的时候，Visual Studio.net提示你最好用transaction来代替Open()和Close()函数。使用transaction的好处是你不用再手动编写关闭ObjectARX对象的代码，因为系统已经自动帮你做好了(呵呵，这就好像可以自动关闭的水龙头)。<o:p></o:p>

下面是使用transaction的例子。<o:p></o:p>

public void CreateLine()<o:p></o:p>

{<o:p></o:p>

 Point3d startPoint=new Point3d(4,2,0);<o:p></o:p>

 Point3d endPoint=new Point3d(10,7,0);<o:p></o:p>

 Line line=new Line(startPoint,endPoint);<o:p></o:p>

 Database db= Application.DocumentManager.MdiActiveDocument.Database;<o:p></o:p>

 DBTransMan tm=db.TransactionManager;<o:p></o:p>

 using(Transaction trans=tm.StartTransaction())<o:p></o:p>

 {<o:p></o:p>

 BlockTable bt=(BlockTable)tm.GetObject(db.BlockTableId,OpenMode::ForRead,true);<o:p></o:p>

 BlockTableRecord btr=(BlockTableRecord) tm.GetObject(bt,OpenMode::ForWrite,true);<o:p></o:p>

 btr.AppendEntity(line);<o:p></o:p>

 tm.AddNewlyCreatedDBObject(line,true);<o:p></o:p>

 trans.Commit();<o:p></o:p>

 }<o:p></o:p>

}<o:p></o:p>

在以后的例子，我都会用transaction来写相关的代码。<o:p></o:p>

下面的CreateCircle()函数创建一个圆并把它加入到模型空间块表记录中：<o:p></o:p>

public void CreateCircle()<o:p></o:p>

{<o:p></o:p>

 Point3d center=new Point3d(9.0,3.0,0.0);<o:p></o:p>

 Vector3d normal=new Vector3d(0.0,0.0,1.0);<o:p></o:p>

 Circle circle=new Circle(center,normal,2.0);<o:p></o:p>

 Database db= Application.DocumentManager.MdiActiveDocument.Database;<o:p></o:p>

 DBTransMan tm=db.TransactionManager;<o:p></o:p>

 using(Transaction trans=tm.StartTransaction())<o:p></o:p>

 {<o:p></o:p>

 BlockTable bt=(BlockTable)tm.GetObject(db.BlockTableId,OpenMode::ForRead,true);<o:p></o:p>

 BlockTableRecord btr=(BlockTableRecord) tm.GetObject(bt,OpenMode::ForWrite,true);<o:p></o:p>

 btr.AppendEntity(circle);<o:p></o:p>

 tm.AddNewlyCreatedDBObject(circle,true);<o:p></o:p>

 trans.Commit();<o:p></o:p>

 }<o:p></o:p>

 <o:p></o:p>

}<o:p></o:p>

下面的代码演示了如何从数据库中获得层表，创建一个新的层表记录，命名这个记录(ASDK_MYLAYER)。层表记录最后被加入到层表中。<o:p></o:p>

public void CreateNewLayer()<o:p></o:p>

{<o:p></o:p>

 Database db= Application.DocumentManager.MdiActiveDocument.Database;<o:p></o:p>

 DBTransMan tm=db.TransactionManager;<o:p></o:p>

 using(Transaction trans=tm.StartTransaction())<o:p></o:p>

 {<o:p></o:p>

 LayerTable lt=( LayerTable)tm.GetObject(db.LayerTableId,OpenMode::ForWrite,true);<o:p></o:p>

 LayerTableRecord ltr=new LayerTableRecord();<o:p></o:p>

 ltr.Name="ASDK_MYLAYER";<o:p></o:p>

 lt.Add(ltr);<o:p></o:p>

 tm.AddNewlyCreatedDBObject(ltr,true);<o:p></o:p>

 trans.Commit();<o:p></o:p>

 }<o:p></o:p>

}<o:p></o:p>

 <o:p></o:p>

 <o:p></o:p>

打开ObjectARX对象<o:p></o:p>

这部分的代码向你讲述当你处理数据库驻留对象时，你必须遵守的打开和关闭对象的规则。这个规则会保证当需要访问对象时它们会在内存中，当不需要它们的时候则被记录到磁盘。在你修改一个对象之前，你必须像下面的例子一样打开它：<o:p></o:p>

tm.GetObject(objId,OpenMode::ForWrite,true);<o:p></o:p>

OpenMode是一个枚举类型，它表示你打开对象是用来读(ForRead)、写(ForWrite)或通知(ForNotify)。如果打开对象是用来写的话，那么你可以修改它。<o:p></o:p>

一个新生成的对象实例被认为是打开用来写的。一个对象只有被加入到数据库后才能关闭。你可以在对象被加入到数据库之前自由地删除它。但如果对象已被加入到数据库后，你就不能直接删除它。你可以调用DBObject的Erase()函数来擦除它。被擦除的对象仍然会保留在数据库中直到数据库被销毁为止，但当AutoCAD图形被保存时，它不会被保存。<o:p></o:p>

警告！如果直接删除已加入到数据库中的对象，那么会导致AutoCAD终止。<o:p></o:p>

 <o:p></o:p>

在组字典中加入一个组<o:p></o:p>

下面的代码使用CreateLine()函数和CreateCircle()函数创建的直线和圆来创建一个组，然后把这个组加入到组字典中。直线和圆的ID被当作参数传递到函数中。请注意组字典是如何打开用于写、修改。<o:p></o:p>

public void CreateGroup(ObjectIdCollection objIds,string groupName)<o:p></o:p>

{<o:p></o:p>

 Group group=new Group(groupName,true);<o:p></o:p>

 group.Append(objIds);<o:p></o:p>

 Database db= Application.DocumentManager.MdiActiveDocument.Database;<o:p></o:p>

 DBTransMan tm=db.TransactionManager;<o:p></o:p>

 using(Transaction trans=tm.StartTransaction())<o:p></o:p>

 {<o:p></o:p>

 DBDictionary groupDict =<o:p></o:p>

(DBDictionary)tm.GetObject(db.GroupDictionaryId,OpenMode::ForWrite,true);<o:p></o:p>

 groupDict.SetAt(groupName,group);<o:p></o:p>

 tm.AddNewlyCreatedDBObject(groupp,true);<o:p></o:p>

 trans.Commit();<o:p></o:p>

 }<o:p></o:p>

 <o:p></o:p>

}<o:p></o:p>

页: [1]

明经CAD社区's Archiver

ObjectARX帮助文档的.net版本(第二章）