Share

AcTransactionReactor

Class Hierarchy

AcRxObject
    AcTransactionReactor

C++

class AcTransactionReactor : public AcRxObject;

File

dbtrans.h

Description

The AcTransactionReactor class is designed to be used as a base class for custom reactor classes defined in ObjectARX applications. Such custom classes would override the desired member functions of the base class to receive notification of desired events occurring within the transaction manager for ObjectARX. See the notification section of the ObjectARX Developer's Guide for more information on the reactor mechanism.

While it is possible to instantiate objects of the AcTransactionReactor class, the member functions of the AcTransactionReactor class have empty default implementations (that is, they simply return when called), so objects of this class do nothing but waste clock cycles.

Remarks

You use this class by defining a class that inherits from AcTransactionReactor. You instantiate an object of the derived class and add this reactor object to the reactor chain of the transaction manager by calling the addReactor() method of the transaction manager. A pointer to the transaction manager object can be obtained by using the macro actrTransactionManager. For example:

actrTransactionManager->addReactor(pMyReactorObject);

Note Releases prior to AutoCAD 2000 did not support multiple transaction managers, so all reactor methods only needed the current number of transactions. Since AutoCAD 2000 supports multiple transaction managers, the reactor methods need to be passed which transaction manager is sending the notification, so there are now reactor methods that include a transaction manager argument as well as a transaction count argument. These new methods are intended to be replacements for the old methods that did not have the AcDbTransactionManager pointer argument. The old methods are being left in place until the next release of AutoCAD in order to allow ObjectARX applications to migrate more conveniently. Each of these new notifications is sent immediately after the corresponding older (no transaction manager pointer) version of the notification.

Links

AcTransactionReactor Methods

See Also

AcTransactionManager

Was this information helpful?