反应器类派生于AcRxObject而不是AcDbObject,因为他们不是数据库对象,没有ID,拥有关系也不适用。
不同类型的反应器接收不同类型的通知事件。派生于AcDbDatabaseReactor的数据库反应器(database reactor)接收与数据库状态相关的事件,例始当一个对象被加入到数据库,在数据库中被修改或删除。这种反应器的通知发送者是数据库,所以它被加入到数据库的反应器列表中。派生于AcDbObjectReactor的对象反应器(object reactor)负责接收对象(object)级别的事件,比如复制、删除、修改一个对象。它可以被加入到任何AcDbObject对象的反应器列表中。派生于AcEditorReactor的编辑反应器(editor reactor)负责接收AutoCAD特殊的事件,例如加载或卸载一张图,开始或结束一个命令以及其他类型的用户交互。AcEditor对象AcEditorReactor的唯一通知发送者。下面是反应器类的继承图:
上面的反应器都是临时反应器类。如你想你的程序接收事件通知,通常使用临时反应器去监视数据库对象事件、数据库事件、用户交互以及应用程序运行时的其他系统事件。
另外一种类型的反应器叫永久反应器,用一个数据库对象(AcDbObject类及其派生类的实例)作为反应器。数据库对象能像发送通知一样接收通知。永久反应器在数据库内的依赖关系是数据库的一部分,因此他们会被保存在DWG和DXF文件中,当文件加载时又会被重建。
将AcDbObject用作反应器
1. 派生一个新的AcDbObject类,并实现你的对象要负责事件的通知函数。
2. 实例化对象反应器。
3. 将对象反应器加入到数据库,并给他设置一个拥有者,最好是容器对象,以便他能被正确存入取出。
4. 使用addPersistentReactor()函数将对象反应器加入到通知发送者的反应器列表中。这个函数要求你传入对象反应器的ID,这个对象反应器就是你在第2步创建的。
注意:当你复制一个对象时,附加在对象上的任何一个永久反应器也将被复制,而临时反应器的附着关系不会被复制。
使用临时反应器,从以下基类中派生一个新类:
AcApDocManagerReactor
监视文档管理系列事件。
AcApLongTransactionReactor
监视长事务相关的动作。
AcDbDatabaseReactor
监视数据库对象的创建、修改和删除。
AcDbEntityReactor
监视一些另外的实体特有的事件,比如修改图像。
AcDbLayoutManagerReactor
监视与布局管理有关的事件。
AcDbObjectReactor
监视与具体数据库对象相关的事件,如创建、修改和删除。
AcDbSummaryInfoReactor
监视与Summary信息相关的改变。
AcEdInputContextReactor
监视与用户输入时的提示相关的事件。
AcEditorReactor
监视AutoCAD特有的事件,比如命令,AutoLISP赋值。
AcRxDLinkerReactor
监视ObjectARX应用程序的加载和卸载。
AcRxEventReactor
监视ObjectARX和ObjectDBX其用的事件。
AcTransactionReactor
监视与事务管理相关的事件,如一个事务的开始、放弃、结束。
在多数情况下,只需标准C++技术就能创建一个新的临时反应器类。为新的反应器类创建一个类的描述符对象的ObjectARX宏,一般不用于派生这些反应器类。
每一个父类都包含了一系列的虚通知函数,这些函数可以在新的派生类中被实现。例如,AcDbObjectReactor就包含了以下这些与对象有关事件的通知函数:
· cancelled()
· copied()
· erased()
· goodbye()
· openedForModify()
· modified()
· subObjModified()
· modifyUndone()
· modifiedXData()
· unappended()
· reappended()
· objectClosed()
每一个函数都要求有一个指针指向通知的发送者。基类AcDbObjectReactor有每一个函数的空实现。在你派生反应器类中,实现你感兴趣的的通知类型函数。然后实例化反应器,然后使用AcDbObject::addReactor()函数将他加到任何数量的数据库对象。添加或删除临时反应器,对象可以是任意状态(读、写、通知)。添加或删除临时对象不会被撤销(undo)机制监视。(对于永久反应器,通知发送对象必须是以写的形式打开,添加或移除反应器会被撤销(undo)机制监视到。)你创建了临时反应器对象,你也要负责删除它。
当一个对象被删除时,例如,它调用了erased()通知函数通知他的反应器列表中的每个反应器。如果你为你的反应器实现了erased()函数,数据库对象会调用这个函数,那么当对象被删除时,你可以采用与你的程序相对应的任务特殊动作。