com.esri.arcgis.geodatabase
Interface IRowEvents

All Superinterfaces:
Serializable
All Known Implementing Classes:
AnnotationFeature, AttributedRelationship, ComplexEdgeFeature, ComplexJunctionFeature, CoverageAnnotationFeature, DimensionFeature, esri_Object, Feature, GeocodedFeature, GeocodingIndexObject, IRowEventsProxy, NALocationFeature, NALocationObject, NALocationRangesFeature, NALocationRangesObject, NATraversalResultElement, RasterCatalogItem, Row, SchematicDiagram, SchematicInMemoryFeatureLink, SchematicInMemoryFeatureNode, SchematicInMemoryFeatureNodeOnLink, SchematicInMemoryFeatureSubLink, SchematicLink, SchematicNode, SchematicNodeOnLink, SchematicSubLink, SimpleEdgeFeature, SimpleJunctionFeature, TopologyErrorFeature

public interface IRowEvents
extends Serializable

Provides access to events that occur when an object is modified, created or deleted.

Remarks

The IRowEvents interface allows implementers of custom row objects to take special action in response to changes made to the state of a row object. The geodatabase calls the methods in the IRowEvents interface as changes are made to the state of a row object (see the description of the IRow::Store and IRow::Delete methods).

The OnChanged method is called by the geodatabase when an application program calls Store on an existing Row object.

The OnNew method is called by the geodatabase when an application program calls Store on a newly created Row object.

The OnDelete method is called by the geodatabase when an application program calls Delete on a Row object.

The OnInitialize method is called by the geodatabase after hydrating a cocreated Row object with its state (its set of field values) but before handing the Row to an application program. This is an opportunity for the Row object to initialize further state and derived member variables.

The OnValidate method is unused (deprecated).

Product Availability

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


Method Summary
 void onChanged()
          An after event that is fired when a custom object is changed.
 void onDelete()
          An after event that is fired when a custom object is deleted.
 void onInitialize()
          An after event that is fired when a custom object is initialized.
 void onNew()
          An after event that is fired when a custom object is Stored for the first time.
 void onValidate()
          An after event that is fired when a custom object is validated.
 

Method Detail

onChanged

void onChanged()
               throws IOException,
                      AutomationException
An after event that is fired when a custom object is changed.

Remarks

The OnChanged method is called by the geodatabase when an application program calls Store on an existing Row object.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

onDelete

void onDelete()
              throws IOException,
                     AutomationException
An after event that is fired when a custom object is deleted.

Remarks

The OnDelete method is called by the geodatabase when an application program calls Delete on a Row object.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

onInitialize

void onInitialize()
                  throws IOException,
                         AutomationException
An after event that is fired when a custom object is initialized.

Remarks

The OnInitialize method is called by the geodatabase after hydrating a cocreated Row object with its state (its set of field values) but before handing the Row to an application program. This is an opportunity for the Row object to initialize further state and derived member variables.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

onNew

void onNew()
           throws IOException,
                  AutomationException
An after event that is fired when a custom object is Stored for the first time.

Remarks

The OnNew method is called by the geodatabase when an application program calls Store on a newly created Row object.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

onValidate

void onValidate()
                throws IOException,
                       AutomationException
An after event that is fired when a custom object is validated.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.