![787142855a230a4012ee117b60b5100d.png](https://i-blog.csdnimg.cn/blog_migrate/8320b48612640008347baa513a527e33.jpeg)
这一章中, 我们将创建一个新的字典对象, 它用来表示我们雇员就职的 ‘ Acme 公司‘ (呵呵,当然是虚构的一家公司)的部门。这个“ 部门” 字典对象将包含一个表示部门经理的记录。我们还会加入代码到雇员创建过程,这个过程会加入一个索引到雇员工作的部门。我们要说明的是如何在DWG文件中创建自定义数据, 包括“ 每个图形” 的自定义数据和“ 每个实体” 的自定义数据。 “ 每个图形” 的自定义数据是指只在整个图形中加入一次的数据,它表示对象可以引用的单一类型或特性。“ 每个实体” 的自定义数据是指是为特定的对象或数据库中的实体加入的数据。
在下面的示例中,我们将加入“ 每个图形” 的自定义数据到命名对象字典(简称NOD)。 NOD存在于每一个DWG 文件中。“ 每个实体” 的自定义数据加入到一个名为“ 扩展字典” 的字典(可选)中,它表示每一个雇员。每一个由DBObject派生的对象都拥有存储自定义数据的扩展字典。而在我们的示例中将包含这种自定义数据如名字、薪水和部门。因此这一章的重点是字典对象和扩展记录( XRecord),它们是我们用来表示自定义数据的容器。
(1)首先让我们来创建表示公司的条目。 在本章的前几个步骤中, 我们将创建如下所示的部门层次结构:
NOD-命名对象字典
ACME_DIVISION-自定义公司字典
销售(Sales) -部门字典
部门经理-部门条目
请打开Lab4文件夹下的Lab4工程,或接着Lab3的代码。
<!--[if !supportLists]-->
1) <!--[endif]-->我们首先要做的是定义一个新的函数,它用来在命名对象字典(NOD)中创建公司字典对象。为这个函数取名为CreateDivision(),,并使用命令属性来定义CREATEDIVISION命令。
下面是这个函数的代码, 它的形式非常简单, 只是用来在NOD中创建一个ACME_DIVISION (用来表示公司)
[CommandMethod("CreateDivision")]
public void CreateDivision()
{
Database db = HostApplicationServices.WorkingDatabase;
Transaction trans = db.TransactionManager.StartTransaction();
Try
{
//首先,获取NOD……
DBDictionary NOD =
(DBDictionary)trans.GetObject(db.NamedObjectsDictionaryId, OpenMode.ForWrite);
//定义一个公司级别的字典
DBDictionary acmeDict;
{
//如果ACME_DIVISION不存在,则转到catch块,这里什么也不做
acmeDict =
(DBDictionary)trans.GetObject(NOD.GetAt("ACME_DIVISION"), OpenMode.ForRead);
}
Catch
{
如果ACME_DIVISION不存在,则创建它并把它加入到NOD中……
acmeDict = new DBDictionary();
NOD.SetAt("ACME_DIVISION", acmeDict);
trans.AddNewlyCreatedDBObject(acmeDict, true);
}
trans.Commit();
}
finally
{
trans.Dispose();
}
}
请仔细阅读一下上面的代码块的结构, 可以通过注释来了解相关的细节。 特别要注意的是我们是如何用一个try-catch块来处理ACME_DIVISION是否存在?如果ACME_DIVISION字典不存在, GetObject()将会抛出异常, catch块被执行,它会创建一个新的字典。
运行这个函数来看它是否可行。 可以使用数据库查看工具来检查字典是否已被加入 (建议使用 ARX SDK的ArxDbg工具)
<!--[if !supportLists]-->
2) <!--[endif]-->接下来,我们要在ACME_DIVISION字典中加入销售(Sales)条目。销售(Sales)条目同样也是一个字典。由于销售(Sales)字典与ACME_DIVISION字典的关系如同ACME_DIVISION字典与NOD,所以代码是类似的。定义下面的代码部分在ACME_DIVISION字典中创建一个名为’ Sales’ 的字典。
代码提示:
BDictionary divDict;
Try
{
divDict = (DBDictionary)trans.GetObject(acmeDict.GetAt("Sales"),
OpenMode.ForWrite);
}
Catch
…
运行函数来看‘ Sales’ 条目是否已加入到ACME_DIVISION字典。
<!--[if !supportLists]-->
3) <!--[endif]-->现在我们要在这个字典中加入一个特殊的记录, 它可以包含任意的自定义数据。 我们要加入的数据类型为扩展记录( XRecord),它可以包含任何东西,因此我们可以让它包含ResultBuffer类的对象( 就是有些人可能非常熟悉的‘ resbuf’ )。 ResultBuffer可以存储不同类型的预定义数据。扩展记录存储任意数目的ResultBuffer关系列表,因此可能会很大。下表是可以包含在ResultBuffer中一些数据类型(位于Database类的DxfCode枚举中):
![3398c3f8146c333558e6f81e00569110.png](https://i-blog.csdnimg.cn/blog_migrate/d4c338a13a84d829876d045b2cbe96cb.jpeg)
在下面的代码部分, 我们将创建只包含一个ResultBuffer的扩展记录。 这个ResultBuffer包含一个单一的的字符串值,它表示’ Sales’ 部门的部门经理的名字。我们使用和加入字典一样的方法加入扩展记录。唯一的区别是扩展记录与字典的不同:
mgrXRec = new Xrecord();
mgrXRec.Data = new ResultBuffer(new TypedValue((int)DxfCode.Text, "Randolph P.Brokwell"));
请看一下我们是怎样使用new来创建一个新的扩展记录。但我们也使用了new来创建一个 ResultBuffer,传入的参数是一个名为‘ TypedValue’ 的对象。 ‘ TypedValue’ 对象和C++中 resbuf的成员‘ restype’ 是类似的。这个对象一般表示一个特定类型的DXF值,我们使用它来组装诸如扩展数据或扩展记录之类的通用数据容器。在这里,我们简单地使用DxfCode.Text键值和“ Randolph P. Brokwell” 数据值来定义一个TypedValue,然后把它作为单一的参数传入ResultBuffer构造函数(由 new来调用)中。XRecord的’ Data’ 属性实际上正是扩展记录链的第一个ResultBuffer, 我们使用它来表示扩展记录链是从什么地方开始的。
以接下来的代码块看起来和前面两个非常相似:
Xrecord mgrXRec;
try
{
mgrXRec =
(Xrecord)trans.GetObject(divDict.GetAt("Department Manager"),
OpenMode.ForWrite);
}
Catch
{
mgrXRec = new Xrecord();
mgrXRec.Data = new ResultBuffer(new
TypedValue((int)DxfCode.Text, "Randolph P. Brokwell"));
divDict.SetAt("Department Manager", mgrXRec);
trans.AddNewlyCreatedDBObject(mgrXRec, true);
}
运行函数并使用数据库查看工具来确定部门经理已被加入到’ Sales’ 字典。
4) 我们已经定义了公司字典, 现在我们要把每个雇员的数据加入到前一章定义的块索引中。我们要加入的数据是:名字、薪水和雇员所属的部门。要加入这些数据,我们要同前几个步骤一样使用扩展记录。 因为我们要加入三个条目, 所以我们要使扩展记录可以把这些数据联系在一起。
一般来说,扩展记录只能存在于字典中。而我们要为每个雇员加入这些数据 (就是本章开头所讲的“ 每个图形” 的自定义数据和“ 每个实体” 的自定义数据) , 那应该怎么做呢?答案就是:每一个对象或AutoCAD中的实体实际上都有一个名为’ 扩展字典( Extension Dictionary) ’ 的可选字典。我们可以把扩展记录直接加入到这个字典中。
请回到我们在上一章创建的CreateEmployee()函数。这个函数是我们创建块索引的地方。 让我们像前面的步骤一样来创建一个新的扩展记录。 因为我们要加入3个条目, 因此我们既可以使用ResultBuffer的Add方法(它会在扩展记录链中加入一个链接),也可以利用ResultBuffer的构造函数(它的一种构造函数可以输入可变数量的参数)。无论用哪一种方法,请在CreateEmployee()函数中使用ResultBuffer来创建一个新的XRecord, ResultBuffer包括以下的类型和值:
Text – “ Earnest Shackleton” (或是你选择的其它雇员的名字)
Real – 72000 或者更多的薪水
JText – “ Sales” 雇员所在的部门
5) 要把上面的扩展记录加入到块索引, 我们必须把它加入到扩展字典。 通常这个字典是不存在的,除非它被明确地创建,块索引就是这种情况。要给一个对象创建扩展字典,你要调用它的成员‘ CreateExtensionDictionary()’ 。这个函数不返回任何值,所以要访问它创建的扩展字典,你还得使用对象的‘ ExtensionDictionary’ 属性。你可以使用类似于以下的代码来创建并访问扩展字典:
br.CreateExtensionDictionary()
DBDictionary brExtDict =
(DBDictionary)trans.GetObject(br.ExtensionDictionary, OpenMode.ForWrite, false);
由于扩展字典也是字典, 我们可以和第3步一样在扩展字典中加入扩展记录。 请完成有关的代码来创建和访问块索引的扩展字典, 加入你在第4步中创建的扩展记录, 然后把扩展记录加入到事务处理。
6) 返回到NOD…… 因为在NOD中创建公司字典只需要一次 (就像创建Employee块一样),因此我们应该把CreateDivision函数的命令属性去掉, 而在CreateEmployeeDefinition()中调用这个函数。请自己完成这些改变。当所有这些都做完后,当CREATE命令第一次运行的时候,所有的函数都会被调用。
7) 下面的步骤和上面的无关。 我们将创建一个函数来遍历模型空间, 以用来查找加入的Employee对象(这里其实是块索引)的数目。在http://VB.NET 或C#中,我们可以把模型空间块表记录( ModelSpace BlockTableRecord)当作一个集合,这样就可以使用For Each(C#是foreach)来遍历它。请仔细研究一下下面的代码片断:
VB.NET:
Dim id As ObjectId ‘ 首先,定义一个For 循环要使用的Object量。
For Each id In btr
Dim ent As Entity = trans.GetObject(id, OpenMode.ForRead, False)
'打开当前的对象!
C#:
foreach (ObjectId id in btr)
{
Entity ent = (Entity)trans.GetObject(id, OpenMode.ForRead, false);
//打开当前的对象!
一旦我们获得模型空间对象, 你们就可以定义一个ObjectId变量, 然后把它用于For Each循环(C#是foreach)。
现在,我们需要使用一些方法来筛选雇员。我们知道模型空间中的对象都是实体,但不全是雇员。我们需要使用一些方法来加以区分。在这里,我们可以使用http://VB.NET的TypeOf关键字并用CType进行类型转换( C#是GetType函数和typeof):
VB.NET:
If TypeOf ent Is BlockReference Then
Dim br As BlockReference = CType(ent, BlockReference)
…
C#:
If(ent.GetType() == typeof(BlockReference))
BlockReference br = (BlockReference)ent;
上面讲的概念对于AutoCAD编程是很重要的, 因为容器对象经常包含不同类型的对象。 你会在 AutoCAD程序的开发中经常碰到这种类型转化。请定义一个名为EmployeeCount()的函数,函数的结构如上所示,它用来统计模型空间中的块索引的数目。 这个函数不会输出任何东西, 但你可以使用逐步调试程序来查看整数变量的增加(每发现一个块索引对象)。
8 ) 接下来,为了把结果输出到命令行,我们需要使用
Application.DocumentManager.MdiActiveDocument.Editor对象的服务。要使用它,请加入下面的代码:
Imports Autodesk.AutoCAD.EditorInput
Imports Autodesk.AutoCAD.ApplicationServices
在函数的内部:
Editor ed = Application.DocumentManager.MdiActiveDocument.Editor;
最后,在循环的后面确定找到了多少个块索引:
ed.WriteMessage("Employees Found: " + nEmployeeCount.ToString());
![5e32609ea3d3e194f191944f54a6a33c.png](https://i-blog.csdnimg.cn/blog_migrate/925901b73dbeca062bcaef591f112e22.png)