com.esri.arcgis.geodatabase
Class ITopologyClassEventsProxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      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.

Supported Platforms

Windows, Solaris, Linux

See Also:

Serialized Form

Field Summary

Fields inherited from class com.esri.arcgis.interop.Dispatch

DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, E

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	readExternal(ObjectInput in)
void	removeListener(String iidStr, Object theListener)
void	writeExternal(ObjectOutput out)

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, queryInterface, release, setNativeMode, setPropertyByName, toString, vtblInvoke

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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.

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Overrides:

writeExternal in class com.esri.arcgis.interop.Dispatch

Throws:

IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException

Specified by:

readExternal in interface Externalizable

Overrides:

readExternal in class com.esri.arcgis.interop.Dispatch

Throws:

IOException

ClassNotFoundException