Provides access to events that occur when related objects change, move or rotate and confirms that the event be sent.
The IConfirmSendRelatedObjectEvents is an optional interface for class extensions used to confirm the reception of notifications from related objects.
When To Use
This interface can be implemented by a class extension to filter the notifications from a related class.
When an object that participates in a relationship is modified, moved, or rotated (alone or in a set), its related objects and their classes will be notified if relationship notification is set in that direction. Typically, related objects and classes are only interested in certain changes on an object. The methods of this interface allow an object class extension to prevent or confirm that notifications should be handled.
|ConfirmSendRelatedObjectChanged||Notifies this object that a related object changed and asks if events should be sent.|
|ConfirmSendRelatedObjectMoved||Notifies this object that a related object moved and asks if events should be sent.|
|ConfirmSendRelatedObjectRotated||Notifies this object that a related object rotated and asks if events should be sent.|
|ConfirmSendRelatedObjectSetMoved||Notifies this object that a set of objects with relationships to the input set of objects moved and asks if events should be sent.|
|ConfirmSendRelatedObjectSetRotated||Notifies this object that a set of objects with relationships to the input set of objects rotated and asks if events should be sent.|
CoClasses that implement IConfirmSendRelatedObjectEvents
|CoClasses and Classes||Description|
|AnnotationFeatureClassExtension (esriCarto)||An Esri annotation feature class extension.|
Each property on IConfirmSendRelatedObjectEvents corresponds to a method on IRelatedObjectClassEvents2 and IRelatedObjectEvents (for example, ConfirmSendRelatedObjectChanged corresponds to RelatedObjectChanged on both interfaces).
The decision to confirm the sending of messages could be based on criteria such as a particular field having been changed. An object can be analyzed for which fields have been modified by accessing the IRowChanges interface or the IFeatureChanges interface for shape information. By eliminating unnecessary calls to IRelatedObjectClassEvents2 and IRelatedObjectEvents, editing performance can be optimized.
ConfirmSendRelatedObjectMoved and ConfirmSendRelatedObjectRotated are currently reserved, and should not define any functionality. ConfirmSendRelatedObjectSetMoved and ConfirmSendRelatedObjectSetRotated will be always be called, even if the sets only contain a single object.