com.esri.arcgis.geodatabase
Class IRelationshipClassEventsAdapter

java.lang.Object
  com.esri.arcgis.geodatabase.IRelationshipClassEventsAdapter

All Implemented Interfaces:

IRelationshipClassEvents, Serializable, EventListener

public class IRelationshipClassEventsAdapter
extends Object
implements IRelationshipClassEvents

See Also:

Serialized Form

Constructor Summary

IRelationshipClassEventsAdapter()

Method Summary

void	onChange(IRelationshipClassEventsOnChangeEvent theEvent) This event is fired when a relationship's attributes are updated.
void	onCreate(IRelationshipClassEventsOnCreateEvent theEvent) This event is fired when a new relationship is created in the relationship class.
void	onDelete(IRelationshipClassEventsOnDeleteEvent theEvent) This event is fired when an relationship is deleted from the relationship class.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IRelationshipClassEventsAdapter

public IRelationshipClassEventsAdapter()

Method Detail

onCreate

public void onCreate(IRelationshipClassEventsOnCreateEvent theEvent)
              throws IOException,
                     AutomationException

This event is fired when a new relationship is created in the relationship class.

Description

OnCreate is fired if you create a new simple or attributed relationship in one of the following ways :

• Call IRelationshipClass.CreateRelationship
• Call ITable.CreateRow on an AttributedRelationshipClass

Note that if you call IRelationshipClass::CreateRelationship on a simple relationship this changes the foreign key inside the destination object to point to the new origin object : i.e the old relationship is deleted in creating the new relationship. No OnDelete event will be fired corresponding to this implicit deletion. An application may be interested in the details of the relationship that was implicitly deleted. This can be achieved by getting the ISimpleRelationshipChanges interface on the Relationship object passed in to the OnCreate event. This interface has a single property OldOriginKey that the application can use to get the key of the origin object. Any further fetching of the old origin object is up to the application using this key.

Note that one can also create and delete relationships implicitly by directly using put_Value to set the origin foreign key field inside the destination object in the case of a simple relationship class. However, no events in IRelationshipClassEvents will be fired if the user does this (for eg. uses the Table document to directly set foreign key values in the destination object).

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

onCreate in interface IRelationshipClassEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onDelete

public void onDelete(IRelationshipClassEventsOnDeleteEvent theEvent)
              throws IOException,
                     AutomationException

This event is fired when an relationship is deleted from the relationship class.

Description

OnDelete is fired if you delete a simple or attributed relationship in one of the following ways:

• Call IRelationshipClass.DeleteRelationship
• Call IRow.Delete on an AttributedRelationship

Note that one can also create and delete relationships implicitly by directly using put_Value to set the origin foreign key field inside the destination object in the case of a simple relationship class. However, no events in IRelationshipClassEvents will be fired if the user does this (for eg. uses the Table document to directly set foreign key values in the destination object).

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

onDelete in interface IRelationshipClassEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onChange

public void onChange(IRelationshipClassEventsOnChangeEvent theEvent)
              throws IOException,
                     AutomationException

This event is fired when a relationship's attributes are updated.

Description

OnChange is fired if you do any of the following:

• Update an attribute value of an AttributedRelationshipClass

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

onChange in interface IRelationshipClassEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.