AutoCAD .net 二次开发官方教程及源码C#版（7）(源码下载)

示例下载
第7章 事件
本章将讨论AutoCAD中的事件。我们将介绍事件处理函数的使用，特别是监视AutoCAD命令的事件处理函数和监视被AutoCAD命令修改的对象的事件处理函数。在解释怎样在C#中实现AutoCAD的事件处理之前，我们将首先简要地讨论一下.NET中的事件。

本章节包含内容如下：

第1部分 C#中的事件

第1a部分 代理

第1b部分 +=和-=语句

第2部分 处理.NET中的AutoCAD事件

第3部分 使用事件处理函数来控制AutoCAD的行为

 

第1部分 C#中的事件

事件只是用来通知一个行为已经发生的信息。在ObjectARX中，我们使用反应器(reactor)来处理AutoCAD的事件。而在AutoCAD .NET API中，ObjectARX反应器被换成了事件。

事件处理函数（或者叫回调函数）是用来监视和反馈程序中出现的事件。事件可以以不同的形式出现。

在介绍AutoCAD .NET API中的事件之前，让我们先来简单地了解一下代理。

本章节包含内容如下：

第1a部分 代理

第1b部分 +=和-=语句


第1a部分 代理

代理是一个存储方法索引的类（概念与函数指针类似）。代理对方法是类型安全的（与C中的函数指针类似）。代理有特定的形式和返回类型。代理可以封装符合这种特定形式的任何方法。

代理的一个用途就是作为产生事件的类的分发器。事件是.NET环境中第一级别的对象。虽然C#把事件处理的许多细节给隐藏掉了，但事件总是由代理来实现的。事件代理可以多次调用（就是它们可以存储多于１个的事件处理方法的索引）。它们保存了用于事件的一个注册事件处理的列表。一个典型的代理有以下的形式：

public delegate Event (Object sender, EventArgs e)

第一个参数sender表示引发事件的对象。第二个参数e是一个EventArgs参数（或者是一个派生的类），这个对象通常包含用于事件处理函数的数据。



第1b部分 +=和-=语句

要使用事件处理函数，我们必须把它与事件联系起来。这要通过使用+=语句。+=和-=允许你在运行时连接、断开或修改与事件联系的处理函数。

当我们使用+=语句时，我们要确定事件引发者的名字，并要使用new语句来确定事件处理函数，例如：

MyClass1.AnEvent += new HandlerDelegate(EHandler)

前面我们说过要使用-=语句从事件处理函数中断开事件（移除联系）。语法如下所示：

MyClass1.AnEvent -= new  HandlerDelegate(EHandler)

第2部分 处理.NET中的AutoCAD事件

在ObjectARX中，我们使用反应器来封装AutoCAD事件。在AutoCAD .NET API中，我们可以使用事件来代替ObjectARX反应器。

通常，处理AutoCAD事件的步骤如下：

1.       创建事件处理函数

当一个事件发生时，事件处理函数（或称为回调函数）被调用。任何我们想要处理的回应AutoCAD事件的动作都在事件处理函数中进行。

例如，假定我们只想通知用户一个AutoCAD对象已被加入。我们可以使用AutoCAD数据库事件”ObjectAppended”来完成。我们可以编写回调函数（事件处理函数）如下：

      public void objAppended(object o, ObjectEventArgs e)

      {

         // 在这里加入处理代码

      }

函数中的第一个参数代表AutoCAD数据库。第二个参数代表ObjectEventArgs类，它可能包含对处理函数有用的数据。

2.       把事件处理函数与事件联系起来

为了开始监视动作，我们必须把事件处理函数与事件联系起来。在这里，当一个对象加入到数据库时，ObjectAppended事件将会发生。但是，事件处理函数不会响应这个事件，除非我们把它与这个事件联系起来，例如：

         Database db; 

         db = HostApplicationServices.WorkingDatabase;

         db. ObjectAppended += new ObjectEventHandler(objAppended);

3.       断开事件处理函数

要终止监视一个动作，我们必须断开事件处理函数与事件的联系。当对象被加入时，我们想要停止通知用户这个事件，我们要断开事件处理函数与事件ObjectAppended的联系。

db. ObjectAppended -= new ObjectEventHandler(objAppended);


第3部分 使用事件处理函数来控制AutoCAD的行为

本章的目的是解释AutoCAD事件怎样才能被用于控制AutoCAD图形中的行为。现在，让我们使用前一章（第六章）的内容在AutoCAD图形中创建几个EMPLOYEE块索引。我们不想让用户能改变EMPLOYEE块索引的位置，而对于其它的非EMPLOYEE块索引的位置则没有这个限制。我们将混合使用数据库与文档事件来做到这一点。

首先，我们想要监视将要被执行的AutoCAD命令（使用CommandWillStart事件）。特别地，我们要监视MOVE命令。另外，当一个对象要被修改时，我们应该被通知（使用ObjectOpenedForModify事件），这样我们可以确定它是否为一个EMPLOYEE块索引。如果这时就修改对象可能是无效的，因为我们的修改可能会再次触发事件，从而引起不稳定的行为。所以，我们要等待Move命令的执行结束（使用CommandEnded事件），这时就可以安全地修改对象了。当然，任何对块索引的修改将会触发ObjectOpenedForModify事件。我们还需要设置一些全局变量来表明一个MOVE命令在运行和被修改的对象是一个EMPLOYEE块索引。

注意：因为本章需要比较多的代码来获得想要的结果，所以我们不会解释任何与事件处理无关的代码，而只是将它们粘贴到事件处理函数中。这里的重点是成功创建和注册事件处理函数。

第一步：创建新工程

我们以第六章的工程开始。请新加入一个类AsdkClass2。我们还要加入四个全局变量。前两个是Boolean型的：一个用来表示我们监视的命令是否是活动的，另外一个用来表示ObjectOpenedForModify事件处理函数是否该被忽略。

      //全局变量

      bool bEditCommand;

      bool bDoRepositioning; 

 

接下来，我们要声明一个全局变量来表示一个ObjectIdCollection，它用来存储我们所选择的要修改的对象的ObjectID。

      ObjectIdCollection changedObjects = new ObjectIdCollection();

最后，我们要声明一个全局变量来表示一个Point3dCollection，它用来包含我们所选对象的位置（三维点）。

      Point3dCollection employeePositions = new Point3dCollection();

第２步：创建第一个文档事件处理函数（回调函数）

现在我们要创建一个事件处理函数。当AutoCAD命令开始执行的时候它会通知我们。我们要检查GlobalCommandName的值是否为MOVE。

         if ( e.GlobalCommandName == "MOVE" )

         {

         }

如果MOVE命令开始执行的话，我们要相应地设置Boolean变量bEditCommand的值，这样我们可以知道我们所监视的命令是活动的。同样地，我们应该把另外一个Boolean变量bDoRepositioning设置为false来忽略ObjectOpenedForModify事件处理函数。两个变量设置好以后，在命令活动期间，我们必须要获得所选块索引的信息。

我们还应该把两个集合对象的内容清空。我们只关心当前选择的对象。

第３步：　创建数据库事件处理函数（回调函数）

无论什么时候一个对象被打开并要被修改时，数据库事件处理函数会被调用。当然，如果这时我们监视的命令不是活动的，我们就应该跳过任何被这个回调函数调用的内容。

         if ( bEditCommand == false )

         {

            return;

         }

同样地，如果我们监视的命令已经结束，而ObjectOpenedForModify事件被另一个回调函数再次触发的话，而这时有对象被修改时，我们要阻止所有由这个回调函数执行的动作。

         if ( bDoRepositioning == true )

         {

            return;

         }

这个回调函数剩余部分的代码用来验证我们是否正在处理EMPLOYEE块索引。如果是的话，我们就获取它的ObjectID和位置（三维点）。下面的代码可以被粘贴到这个事件处理函数函数。

  1      public void objOpenedForMod(object o, ObjectEventArgs e)
  2
  3
  4      {
  5
  6
  7         if ( bEditCommand == false ) 
  8
  9
 10         {
 11
 12
 13            return;
 14
 15
 16         }
 17
 18
 19
 20
 21         if ( bDoRepositioning == true ) 
 22
 23
 24         {
 25
 26
 27            return;
 28
 29
 30         }
 31
 32
 33
 34
 35         ObjectId objId; 
 36
 37
 38         objId = e.DBObject.ObjectId;
 39
 40
 41
 42
 43         Transaction  trans;  
 44
 45
 46         Database  db;  
 47
 48
 49         db = HostApplicationServices.WorkingDatabase;
 50
 51
 52
 53
 54         trans = db.TransactionManager.StartTransaction();
 55
 56
 57
 58
 59         using(Entity ent  = (Entity)trans.GetObject(objId, OpenMode.ForRead, false))
 60
 61
 62         {
 63
 64
 65            if ( ent.GetType().FullName.Equals( "Autodesk.AutoCAD.DatabaseServices.BlockReference" ) )
 66
 67
 68            { //We use .NET//s RTTI to establish type.
 69
 70
 71                BlockReference br   = (BlockReference)ent;
 72
 73
 74                //Test whether it is an employee block
 75
 76
 77                //open its extension dictionary
 78
 79
 80                if ( br.ExtensionDictionary.IsValid ) 
 81
 82
 83                {
 84
 85
 86                   using(DBDictionary brExtDict  = (DBDictionary)trans.GetObject(br.ExtensionDictionary, OpenMode.ForRead))
 87
 88
 89                   {
 90
 91
 92                      if ( brExtDict.GetAt("EmployeeData").IsValid ) 
 93
 94
 95                      {
 96
 97
 98                         //successfully got "EmployeeData" so br is employee block ref
 99
100
101
102
103                         //Store the objectID and the position
104
105
106                         changedObjects.Add(objId);
107
108
109                         employeePositions.Add(br.Position);
110
111
112                         //Get the attribute references,if any
113
114
115                         AttributeCollection atts;  
116
117
118                         atts = br.AttributeCollection;
119
120
121                         if ( atts.Count > 0 ) 
122
123
124                         {
125
126
127                            foreach(ObjectId attId in atts )
128
129
130                            {
131
132
133                               AttributeReference att; 
134
135
136                              using(att = (AttributeReference)trans.GetObject(attId, OpenMode.ForRead, false))
137
138
139                               {
140
141
142                                  changedObjects.Add(attId);
143
144
145                                  employeePositions.Add(att.Position);
146
147
148                               }
149
150
151                            }
152
153
154                         }
155
156
157                      }
158
159
160                   }
161
162
163                }
164
165
166            }
167
168
169         }
170
171
172         trans.Commit();
173
174
175      }
176

第４步　创建第二个文档事件处理函数（回调函数）

当一个命令结束时，第三个事件处理函数被调用。同样地，我们要检查全局变量来验证这个将要结束的命令是我们监视的命令。如果是我们监视的，那么我们要重置这个变量：

         if ( bEditCommand == false )

         {

            return;

         }

         bEditCommand = false;

这个回调函数执行的动作将会再次触发ObjectOpenedForModify事件。我们必须确定在这个回调函数中跳过了所有与此事件有关的动作。

         //设置标志来跳过OpenedForModify处理函数

         bDoRepositioning = true;

这个回调函数的剩余代码用来把EMPLOYEE块索引和它的关联属性引用的当前（修改过的）位置与它们的初始位置作比较。如果位置改变了，我们在这个回调函数中把它们重置这初始的位置。下面的代码可以被粘贴到这个事件处理函数中。

  1      public void cmdEnded(object o  , CommandEventArgs e)
  2
  3
  4      {
  5
  6
  7         //Was our monitored command active?
  8
  9
 10         if ( bEditCommand == false ) 
 11
 12
 13         {
 14
 15
 16            return;
 17
 18
 19         }
 20
 21
 22
 23
 24         bEditCommand = false;
 25
 26
 27
 28
 29         //Set flag to bypass OpenedForModify handler
 30
 31
 32         bDoRepositioning = true;
 33
 34
 35
 36
 37         Database db   = HostApplicationServices.WorkingDatabase;
 38
 39
 40         Transaction trans ; 
 41
 42
 43         BlockTable bt;  
 44
 45
 46         Point3d oldpos;  
 47
 48
 49         Point3d newpos;  
 50
 51
 52         int i ;
 53
 54
 55         for ( i = 0; i< changedObjects.Count; i++)
 56
 57
 58         {
 59
 60
 61            trans = db.TransactionManager.StartTransaction();
 62
 63
 64            using( bt = (BlockTable)trans.GetObject(db.BlockTableId, OpenMode.ForRead) )
 65
 66
 67            {
 68
 69
 70                using(Entity ent   = (Entity)trans.GetObject(changedObjects[i], OpenMode.ForWrite))
 71
 72
 73                {
 74
 75
 76                   if ( ent.GetType().FullName.Equals("Autodesk.AutoCAD.DatabaseServices.BlockReference") ) 
 77
 78
 79                   { //We use .NET//s RTTI to establish type.
 80
 81
 82                      BlockReference br = (BlockReference)ent;
 83
 84
 85                      newpos = br.Position;
 86
 87
 88                      oldpos = employeePositions[i];
 89
 90
 91
 92
 93                      //Reset blockref position
 94
 95
 96                      if ( !oldpos.Equals(newpos) ) 
 97
 98
 99                      {
100
101
102                         using( trans.GetObject(br.ObjectId, OpenMode.ForWrite) )
103
104
105                         {
106
107
108                            br.Position = oldpos;
109
110
111                         }
112
113
114                      }
115
116
117                   }
118
119
120                   else if ( ent.GetType().FullName.Equals("Autodesk.AutoCAD.DatabaseServices.AttributeReference") ) 
121
122
123                   {
124
125
126                      AttributeReference att = (AttributeReference)ent;
127
128
129                      newpos = att.Position;
130
131
132                      oldpos = employeePositions[i];
133
134
135
136
137                      //Reset attref position
138
139
140                      if ( !oldpos.Equals(newpos) ) 
141
142
143                      {
144
145
146                         using( trans.GetObject(att.ObjectId, OpenMode.ForWrite))
147
148
149                         {
150
151
152                            att.Position = oldpos;
153
154
155                         }
156
157
158                      }
159
160
161                   }
162
163
164                }
165
166
167            }
168
169
170            trans.Commit();
171
172
173         }
174
175
176      }
177

第５步　　创建命令来注册/断开事件处理函数

创建一个ADDEVENTS命令，使用+=语句来把上面的３个事件处理函数连接到各自的事件。在这个命令中，我们还应该设置全局Boolean变量：

         bEditCommand = false;

         bDoRepositioning = false;

 

创建另外一个命令REMOVEEVENTS，使用-=语句把事件处理函数与事件断开。

第６步：　测试工程

要测试这个工程，请使用CREATE命令创建一个或多个EMPLOYEE块索引。如果你要作比较的话，你也可以插入一些非EMPLOYEE的块索引。

在命令行中键入ADDEVENTS命令来执行它。

在命令行中输入MOVE命令，然后选择你想要的块索引。注意，当MOVE命令结束时，EMPLOYEE块索引（包括属性）还留在原处。

执行REMOVEEVENTS命令，然后在试一下MOVE命令。注意，EMPLOYEE块索引现在可以被移动了。

附加的问题：添加一个附加的回调函数，当用户改变EMPLOYEE块索引的”Name”属性时，这个回调函数被触发。