com.esri.arcgis.geodatabase
Class IWorkspaceEditControlProxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.geodatabase.IWorkspaceEditControlProxy

All Implemented Interfaces:

IWorkspaceEditControl, Externalizable, Serializable

public class IWorkspaceEditControlProxy
extends com.esri.arcgis.interop.Dispatch
implements IWorkspaceEditControl, Serializable

Provides access to method that controls if insert and update cursors on simple classes can bypass store events

Remarks

By default on simple classes, insert cursors handed out by the geodatabase will internally bypass the CreateRow and Store mechanisms when creating and updating objects. Tools that use insert cursors include Planarize, Create Features and the Object Loader. When CreateRow and Store are bypassed, subsequent events are not fired for clients listening to IEditEvents and IObjectClassEvents.

This can be overridden on the class level by implemeting IObjectClassInfo2 on its class extension and setting the CanBypassStore property to False. False indicates that insert cursors will not bypass Store and subsequent custom behavior implemented by the row object for this class.

IWorkspaceEditControl allows you to override this for all classes in an edit session by logically making CanBypassStore equal to False for all classes in that edit session. Doing this will ensure that when features are inserted, updated or deleted by editor tools that use insert and update cursors they do not bypass Store and subsequent edit events.

For a simple class in which SetStoreEventsRequired has not been called, edits will not broadcast IObjectClassEvents which in turn will not be rebroadcast as IEditEvents (for which a custom editor extension may be listening). Calling SetStoreEventsRequired will ensure these events are always broadcast.

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

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

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
void	removeListener(String iidStr, Object theListener)
void	setStoreEventsRequired() Indicates that insert and update cursors on simple classes cannot bypass store events

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

IWorkspaceEditControlProxy

public IWorkspaceEditControlProxy()

IWorkspaceEditControlProxy

public IWorkspaceEditControlProxy(Object obj)
                           throws IOException

Throws:

IOException

IWorkspaceEditControlProxy

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

setStoreEventsRequired

public void setStoreEventsRequired()
                            throws IOException,
                                   AutomationException

Indicates that insert and update cursors on simple classes cannot bypass store events

Description

This method instructs the geodatabase to fire events when features are created/modified/deleted through a cursor that otherwise wouldn't fire the events.

Remarks

You must be editing features within a edit session for events to be fired.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

setStoreEventsRequired in interface IWorkspaceEditControl

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.