com.esri.arcgis.controls
Class IEngineEditEventsProxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.controls.IEngineEditEventsProxy

All Implemented Interfaces:

IEngineEditEvents, Externalizable, Serializable, EventListener

public class IEngineEditEventsProxy
extends com.esri.arcgis.interop.Dispatch
implements IEngineEditEvents, Serializable

Provides access to the EngineEditor's events.

Description

This interface is new at ArcGIS 9.3.

Implement IEngineEditEvents to listen for specific events that occur during an edit session.

The following code example creates a listener to determine when an editing session has started. For more information refer to the "How to listen to edit events" and "How to wire ArcObjects.NET events" documents.

Product Availability

Available with ArcGIS Engine.

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

	IEngineEditEventsProxy()
	IEngineEditEventsProxy(Object obj)
protected	IEngineEditEventsProxy(Object obj, String iid)

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
void	onAbort(IEngineEditEventsOnAbortEvent theEvent) Fires when an edit operation is aborted.
void	onAfterDrawSketch(IEngineEditEventsOnAfterDrawSketchEvent theEvent) Fires after the edit sketch is drawn.
void	onBeforeStopEditing(IEngineEditEventsOnBeforeStopEditingEvent theEvent) Fires before editing stops.
void	onBeforeStopOperation(IEngineEditEventsOnBeforeStopOperationEvent theEvent) Fires before an edit operation stops.
void	onChangeFeature(IEngineEditEventsOnChangeFeatureEvent theEvent) Fires when features are modified.
void	onConflictsDetected(IEngineEditEventsOnConflictsDetectedEvent theEvent) Fires when editing conflicts are detected during save.
void	onCreateFeature(IEngineEditEventsOnCreateFeatureEvent theEvent) Fires when new features are created.
void	onCurrentTaskChanged(IEngineEditEventsOnCurrentTaskChangedEvent theEvent) Fires when the current task changes.
void	onCurrentZChanged(IEngineEditEventsOnCurrentZChangedEvent theEvent) Called when the CurrentZ changes.
void	onDeleteFeature(IEngineEditEventsOnDeleteFeatureEvent theEvent) Fires when features are deleted.
void	onSaveEdits(IEngineEditEventsOnSaveEditsEvent theEvent) Fires when edits are saved.
void	onSelectionChanged(IEngineEditEventsOnSelectionChangedEvent theEvent) Fires when the selection changes.
void	onSketchFinished(IEngineEditEventsOnSketchFinishedEvent theEvent) Fires when the edit sketch is finished.
void	onSketchModified(IEngineEditEventsOnSketchModifiedEvent theEvent) Fires when the edit sketch is modified.
void	onStartEditing(IEngineEditEventsOnStartEditingEvent theEvent) Fires when editing begins.
void	onStartOperation(IEngineEditEventsOnStartOperationEvent theEvent) Fires when an edit operation starts.
void	onStopEditing(IEngineEditEventsOnStopEditingEvent theEvent) Fires when editing ends.
void	onStopOperation(IEngineEditEventsOnStopOperationEvent theEvent) Fires when an edit operation stops.
void	onTargetLayerChanged(IEngineEditEventsOnTargetLayerChangedEvent theEvent) Fires when the target layer changes.
void	onVertexAdded(IEngineEditEventsOnVertexAddedEvent theEvent) Fires when a vertex is added to the edit sketch.
void	onVertexDeleted(IEngineEditEventsOnVertexDeletedEvent theEvent) Fires when a vertex is deleted from the edit sketch.
void	onVertexMoved(IEngineEditEventsOnVertexMovedEvent theEvent) Fires when a vertex is moved in the edit sketch.
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

IEngineEditEventsProxy

public IEngineEditEventsProxy()

IEngineEditEventsProxy

public IEngineEditEventsProxy(Object obj)
                       throws IOException

Throws:

IOException

IEngineEditEventsProxy

protected IEngineEditEventsProxy(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

onSelectionChanged

public void onSelectionChanged(IEngineEditEventsOnSelectionChangedEvent theEvent)
                        throws IOException,
                               AutomationException

Fires when the selection changes.

Description

The OnSelectionChanged event is fired whenever the feature selection status changes during an edit session.

Product Availability

Available with ArcGIS Engine.

Specified by:

onSelectionChanged in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onTargetLayerChanged

public void onTargetLayerChanged(IEngineEditEventsOnTargetLayerChangedEvent theEvent)
                          throws IOException,
                                 AutomationException

Fires when the target layer changes.

Description

The OnTargetLayerChanged event is fired whenever the target layer changes during an edit session. For example, when the IEngineEditLayers::SetTargetLayer method is called programmatically or when the target layer is changed using the ControlsEditingTargetToolControl .

Product Availability

Available with ArcGIS Engine.

Specified by:

onTargetLayerChanged in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onCurrentTaskChanged

public void onCurrentTaskChanged(IEngineEditEventsOnCurrentTaskChangedEvent theEvent)
                          throws IOException,
                                 AutomationException

Fires when the current task changes.

Description

The OnCurrentTaskChanged event is fired whenever the current task changes during an edit session. For example, when a new task from the ControlsEditingTaskToolControl is selected or when the IEngineEditor::CurrentTask is set programmatically.

Product Availability

Available with ArcGIS Engine.

Specified by:

onCurrentTaskChanged in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onSketchModified

public void onSketchModified(IEngineEditEventsOnSketchModifiedEvent theEvent)
                      throws IOException,
                             AutomationException

Fires when the edit sketch is modified.

Description

The OnSketchModified event is fired whenever sketch vertices are deleted, added, or moved during an edit session.

Product Availability

Available with ArcGIS Engine.

Specified by:

onSketchModified in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onSketchFinished

public void onSketchFinished(IEngineEditEventsOnSketchFinishedEvent theEvent)
                      throws IOException,
                             AutomationException

Fires when the edit sketch is finished.

Description

The OnSketchFinished event is fired whenever a sketch is completed during an edit session. For example, a sketch is finished by double-clicking or by calling IEngineEditSketch::FinishSketch or ControlsEditingSketchFinishCommand programmatically.

Product Availability

Available with ArcGIS Engine.

Specified by:

onSketchFinished in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onAfterDrawSketch

public void onAfterDrawSketch(IEngineEditEventsOnAfterDrawSketchEvent theEvent)
                       throws IOException,
                              AutomationException

Fires after the edit sketch is drawn.

Description

The OnAfterDrawSketch event is fired whenever the edit sketch is modified during an edit session. For example, when a vertex is added to, moved or deleted from the edit sketch. It is also fired when the IEngineEditSketch::RefreshSketch method is called programmatically.

Product Availability

Available with ArcGIS Engine.

Specified by:

onAfterDrawSketch in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onStartEditing

public void onStartEditing(IEngineEditEventsOnStartEditingEvent theEvent)
                    throws IOException,
                           AutomationException

Fires when editing begins.

Description

The OnStartEditing event is fired whenever an edit session is started. For example, when the ControlsEditingStartCommand is called or when the IEngineEditor::StartEditing method is called programmatically.

Product Availability

Available with ArcGIS Engine.

Specified by:

onStartEditing in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onStopEditing

public void onStopEditing(IEngineEditEventsOnStopEditingEvent theEvent)
                   throws IOException,
                          AutomationException

Fires when editing ends.

Description

The OnStopEditing event is fired whenever an edit session ends. For example, when the ControlsEditingStopCommand is called or when the IEngineEditor::StopEditing method is called programmatically.

Product Availability

Available with ArcGIS Engine.

Specified by:

onStopEditing in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onConflictsDetected

public void onConflictsDetected(IEngineEditEventsOnConflictsDetectedEvent theEvent)
                         throws IOException,
                                AutomationException

Fires when editing conflicts are detected during save.

Description

The OnConflictsDetected event is fired whenever conflicts are detected after a Save Edits or reconcile operation.

Product Availability

Available with ArcGIS Engine.

Specified by:

onConflictsDetected in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onCreateFeature

public void onCreateFeature(IEngineEditEventsOnCreateFeatureEvent theEvent)
                     throws IOException,
                            AutomationException

Fires when new features are created.

Description

The OnCreateFeature event is fired whenever a new feature is created. The new feature is passed to all listening clients via the IObject parameter.

Product Availability

Available with ArcGIS Engine.

Specified by:

onCreateFeature in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onChangeFeature

public void onChangeFeature(IEngineEditEventsOnChangeFeatureEvent theEvent)
                     throws IOException,
                            AutomationException

Fires when features are modified.

Description

The OnChangeFeature event is fired whenever a feature is changed. The changed feature is passed to all listening clients via the IObject parameter.

Product Availability

Available with ArcGIS Engine.

Specified by:

onChangeFeature in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onDeleteFeature

public void onDeleteFeature(IEngineEditEventsOnDeleteFeatureEvent theEvent)
                     throws IOException,
                            AutomationException

Fires when features are deleted.

Description

The OnDeleteFeature event is fired whenever a new feature is deleted. The deleted feature is passed to all listening clients via the IObject parameter.

Product Availability

Available with ArcGIS Engine.

Specified by:

onDeleteFeature in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onVertexMoved

public void onVertexMoved(IEngineEditEventsOnVertexMovedEvent theEvent)
                   throws IOException,
                          AutomationException

Fires when a vertex is moved in the edit sketch.

Description

The OnVertexMoved event is fired whenever the location of a vertex in the edit sketch is modified. If the edit sketch vertex is modified programmatically call IEngineEditSketch::VertexMoved to ensure that this event is fired.

Product Availability

Available with ArcGIS Engine.

Specified by:

onVertexMoved in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onVertexAdded

public void onVertexAdded(IEngineEditEventsOnVertexAddedEvent theEvent)
                   throws IOException,
                          AutomationException

Fires when a vertex is added to the edit sketch.

Description

The OnVertexAdded event is fired whenever a new vertex is added to an edit sketch. If the edit sketch vertex is added programmatically call IEngineEditSketch::VertexAdded to ensure that this event is fired. This could be used to check that the maximum number of points in a particular sketch is not exceeded before it is added to the edit sketch.

Product Availability

Available with ArcGIS Engine.

Specified by:

onVertexAdded in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onVertexDeleted

public void onVertexDeleted(IEngineEditEventsOnVertexDeletedEvent theEvent)
                     throws IOException,
                            AutomationException

Fires when a vertex is deleted from the edit sketch.

Description

The OnVertexDeleted event is fired whenever a vertex is deleted from an edit sketch. If the edit sketch vertex is deleted programmatically call IEngineEditSketch::VertexDeleted to ensure that this event is fired.

Product Availability

Available with ArcGIS Engine.

Specified by:

onVertexDeleted in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onBeforeStopEditing

public void onBeforeStopEditing(IEngineEditEventsOnBeforeStopEditingEvent theEvent)
                         throws IOException,
                                AutomationException

Fires before editing stops.

Description

The BeforeStopEditing event is fired whenever an edit session ends and before the edits are committed or discarded. Use this event to verify the edit before it is committed.

Product Availability

Available with ArcGIS Engine.

Specified by:

onBeforeStopEditing in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onAbort

public void onAbort(IEngineEditEventsOnAbortEvent theEvent)
             throws IOException,
                    AutomationException

Fires when an edit operation is aborted.

Description

The OnAbort event is fired whenever IEngineEditor::AbortOperation is called.

Product Availability

Available with ArcGIS Engine.

Specified by:

onAbort in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onStartOperation

public void onStartOperation(IEngineEditEventsOnStartOperationEvent theEvent)
                      throws IOException,
                             AutomationException

Fires when an edit operation starts.

Description

The OnStartOperation event is fired whenever an edit operation is started or when IEngineEditor::StartOperation is called.

Product Availability

Available with ArcGIS Engine.

Specified by:

onStartOperation in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onBeforeStopOperation

public void onBeforeStopOperation(IEngineEditEventsOnBeforeStopOperationEvent theEvent)
                           throws IOException,
                                  AutomationException

Fires before an edit operation stops.

Description

OnBeforeStopOperation is fired before the edit operation is finished at which point the sketch is discarded. Use this event to manipulate the sketch geometry before it is committed.

Product Availability

Available with ArcGIS Engine.

Specified by:

onBeforeStopOperation in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onStopOperation

public void onStopOperation(IEngineEditEventsOnStopOperationEvent theEvent)
                     throws IOException,
                            AutomationException

Fires when an edit operation stops.

Description

The OnStopOperation event is fired whenever an edit operation is stopped or when IEngineEditor::StopOperation is called. At this stage a feature has been created using the sketch geometry but the IEngineEditSketch::Geometry is still available.

Product Availability

Available with ArcGIS Engine.

Specified by:

onStopOperation in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onSaveEdits

public void onSaveEdits(IEngineEditEventsOnSaveEditsEvent theEvent)
                 throws IOException,
                        AutomationException

Fires when edits are saved.

Description

The OnSaveEdits event is fired when a user calls the ControlsEditingSaveCommand. This event is not fired when a user stops an edit session by executing ControlsEditingStopCommand or calling the IEngineEditor::StopEditing method.

Product Availability

Available with ArcGIS Engine.

Specified by:

onSaveEdits in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onCurrentZChanged

public void onCurrentZChanged(IEngineEditEventsOnCurrentZChangedEvent theEvent)
                       throws IOException,
                              AutomationException

Called when the CurrentZ changes.

Description

The OnCurrentZChanged event is fired when the value of IEngineEditSketch::CurrentZ is modified.

Product Availability

Available with ArcGIS Engine.

Specified by:

onCurrentZChanged in interface IEngineEditEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.