ArcObjects Library Reference (GeoDatabase)  

IConfirmSendRelatedObjectEvents Interface

Provides access to events that occur when related objects change, move or rotate and confirms that the event be sent.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Description

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.

Members

Description
Method ConfirmSendRelatedObjectChanged Notifies this object that a related object changed and asks if events should be sent.
Method ConfirmSendRelatedObjectMoved Notifies this object that a related object moved and asks if events should be sent.
Method ConfirmSendRelatedObjectRotated Notifies this object that a related object rotated and asks if events should be sent.
Method 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.
Method 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.

Remarks

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.

See Also

IRelatedObjectEvents Interface | IClassExtension Interface