com.esri.arcgis.display
Class IDisplayEventsProxy

java.lang.Object
  extended by com.esri.arcgis.interop.Dispatch
      extended by com.esri.arcgis.display.IDisplayEventsProxy
All Implemented Interfaces:
IDisplayEvents, Externalizable, Serializable, EventListener

public class IDisplayEventsProxy
extends com.esri.arcgis.interop.Dispatch
implements IDisplayEvents, Serializable

Provides access to members that control Display Events.

When To Use

Use this interface to trap for specific events occurring inside a display. For example, you may wish to know whenever a particular display is scrolled. This is the case for the Map object which needs to perform some redrawing operations whenever its screen display is scrolled.

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
  IDisplayEventsProxy()
           
  IDisplayEventsProxy(Object obj)
           
protected IDisplayEventsProxy(Object obj, String iid)
           
 
Method Summary
 void addListener(String iidStr, Object theListener, Object theSource)
           
 void displayFinished(IDisplayEventsDisplayFinishedEvent theEvent)
          Notifies clients when drawing completes.
 void displayInvalidated(IDisplayEventsDisplayInvalidatedEvent theEvent)
          Notifies clients when display is invalidated.
 void displayScrolled(IDisplayEventsDisplayScrolledEvent theEvent)
          Notifies clients when display is scrolled.
 void displayStarted(IDisplayEventsDisplayStartedEvent theEvent)
          Notifies clients when drawing starts.
 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

IDisplayEventsProxy

public IDisplayEventsProxy()

IDisplayEventsProxy

public IDisplayEventsProxy(Object obj)
                    throws IOException
Throws:
IOException

IDisplayEventsProxy

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

displayStarted

public void displayStarted(IDisplayEventsDisplayStartedEvent theEvent)
                    throws IOException,
                           AutomationException
Notifies clients when drawing starts.

Remarks

IDisplay::StartDrawing fires this event to notify clients that drawing has started. The display where drawing was initiated is returned.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
displayStarted in interface IDisplayEvents
Parameters:
theEvent - The event
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

displayFinished

public void displayFinished(IDisplayEventsDisplayFinishedEvent theEvent)
                     throws IOException,
                            AutomationException
Notifies clients when drawing completes.

Remarks

IDisplay::FinishDrawing fires this event to notify clients that drawing has completed. The display where drawing has completed is returned to the client.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
displayFinished in interface IDisplayEvents
Parameters:
theEvent - The event
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

displayInvalidated

public void displayInvalidated(IDisplayEventsDisplayInvalidatedEvent theEvent)
                        throws IOException,
                               AutomationException
Notifies clients when display is invalidated.

Remarks

IScreenDisplay::Invalidate fires this event to notify all clients a display has been invalidated. The display, the area invalidated, the erase setting, and the cacheID are all returned to clients listening to this event.

The Map object is one client that listens for this event and it may in turn fire the IActiveViewEvenets::ViewRefreshed event.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
displayInvalidated in interface IDisplayEvents
Parameters:
theEvent - The event
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

displayScrolled

public void displayScrolled(IDisplayEventsDisplayScrolledEvent theEvent)
                     throws IOException,
                            AutomationException
Notifies clients when display is scrolled.

Remarks

IScreenDisplay::DoScroll fires this event to notify all clients that the display has scrolled. For example, the Map object listens for this event because it needs to perform some drawing operations whenever its display is scrolled.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
displayScrolled in interface IDisplayEvents
Parameters:
theEvent - The event
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.