com.esri.arcgis.geodatabase
Class ITopologyClassEventsProxy

java.lang.Object
  extended by com.esri.arcgis.interop.Dispatch
      extended by com.esri.arcgis.geodatabase.ITopologyClassEventsProxy
All Implemented Interfaces:
ITopologyClassEvents, Externalizable, Serializable, EventListener

public class ITopologyClassEventsProxy
extends com.esri.arcgis.interop.Dispatch
implements ITopologyClassEvents, Serializable

Provides access to events that occur with a topology class.

Remarks

The ITopologyClassEvents interface provides access to the OnValidate event which is fired each time a dirty area is validated in the topology in which the class is participating. The event returns an IGeometry object corresponding the area that was validated.

ITopologyClassEvents can be listened to by class extensions or custom objects when relying on the ITopologyExtensionEvents::OnValidate event isn't ideal. This is useful when you need to implement a geodatabase-level customization that will not be application specific, i.e. dependent upon ArcMap and the Topology extension.

When To Use

Use ITopologyClassEvents for building ClassExtensions when you don't want to rely on catching the ITopologyExtensionEvents OnValidate event. This is handy when you need to implement a geodatabase-level customization that will not be application specific, i.e. dependent upon ArcMap and the Topology extension.

Product Availability

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

See Also:
Serialized Form

Field Summary
 boolean noncastable
           
 
Fields inherited from class com.esri.arcgis.interop.Dispatch
DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, objRef
 
Constructor Summary
  ITopologyClassEventsProxy()
           
  ITopologyClassEventsProxy(Object obj)
           
protected ITopologyClassEventsProxy(Object obj, String iid)
           
 
Method Summary
 void addListener(String iidStr, Object theListener, Object theSource)
           
 void onValidate(ITopologyClassEventsOnValidateEvent theEvent)
          This event is fired when the topology containing the class is validated.
 void removeListener(String iidStr, Object theListener)
           
 
Methods inherited from class com.esri.arcgis.interop.Dispatch
bindUsingMoniker, constructVtblPosTable, convertToNative, cookieForListener, createDispatch, createObjrefMonikerDisplayName, equals, getActiveObject, getActiveObject, getDefaultProperty, getDispatchIdOfName, getLastErrorCode, getMtsObjectContext, getObjRef, getPropertyByName, getPropertyByName, getVtblPos, hashCode, initDispatch, invoke, invokeMethodByName, invokeMethodByName, invokeMethodByName, invokePropertyGetByName, invokePropertyPutByName, invokePropertyPutByRefByName, isNativeMode, isObjRef, optimizedVtblInvoke, queryInterface, readExternal, release, setNativeMode, setPropertyByName, toString, vtblInvoke, writeExternal
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

noncastable

public boolean noncastable
Constructor Detail

ITopologyClassEventsProxy

public ITopologyClassEventsProxy()

ITopologyClassEventsProxy

public ITopologyClassEventsProxy(Object obj)
                          throws IOException
Throws:
IOException

ITopologyClassEventsProxy

protected ITopologyClassEventsProxy(Object obj,
                                    String iid)
                             throws IOException
Throws:
IOException
Method Detail

addListener

public void addListener(String iidStr,
                        Object theListener,
                        Object theSource)
                 throws IOException
Overrides:
addListener in class com.esri.arcgis.interop.Dispatch
Throws:
IOException

removeListener

public void removeListener(String iidStr,
                           Object theListener)
                    throws IOException
Overrides:
removeListener in class com.esri.arcgis.interop.Dispatch
Throws:
IOException

onValidate

public void onValidate(ITopologyClassEventsOnValidateEvent theEvent)
                throws IOException,
                       AutomationException
This event is fired when the topology containing the class is validated.

Remarks

The OnValidate event is fired each time a dirty area is validated in the topology in which the class is participating. Handlers are provided with an IGeometry object corresponding to the dirty areas that were validated. The IGeometry object may represent a single or multi-part polygon or a collection of polygons.

In some cases, using the OnValidate method on feature classes in a Topology may result in a situation where the Topology will always have a Dirty Area such as if the purpose of listening to the OnValidate event is to act on another feature class in the Topology and perform some action on the features in that class.

For example, an extension that listens to the OnValidate event in order to derive features for a feature class by aggregarting the features in the class that is validated. If the dervied features are in a feature class that is in the Topology, the result of the OnValidate event will be a Topology that will always contain a dirty area. The derived feature class should not be in the topology in order for this example to be applicable.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
onValidate in interface ITopologyClassEvents
Parameters:
theEvent - The event
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.