Class IDynamicMapEventsBeforeDynamicDrawEvent

  extended by java.util.EventObject
      extended by com.esri.arcgis.display.IDynamicMapEventsBeforeDynamicDrawEvent
All Implemented Interfaces:

public class IDynamicMapEventsBeforeDynamicDrawEvent
extends EventObject


The BeforeDynamicDraw event is getting fired with two different phases (enum esriDynamicMapDrawPhase). Each phase has a different meaning and usage:

  1. esriDMDPDynamicLayers – This is getting fired on each dynamic cycle that the Dynamic Map re-renders the scene. The BeforeDynamicDraw event is fired just before the first layer is rendered, and AfterDynamicDraw event is fired just after the last layer (including any Graphic Layer) is rendered.
    In this context, there is an active OpenGL Rendering context (with a preset rendering volume, viewport, etc).
    Use this context to plug-in any custom dynamic drawings with the DynamicDisplay API as well as with the OpenGL API. This context can be useful in order to draw dynamic elements behind or on top of the Layers and Graphics, which do not need to be associated with a layer.
  2. esriDMDPLayers – When the Dynamic Map is sensing that it needs to fetch tiles in order to be able to render the scene, the BeforeDynamicDraw will get fired. When the last missing tile will be available and rendered the AfterDynamicDraw event will get fired.
    Note that it is not valid to use the DynamicDisplay API, nor the OpenGL API in this context, since the OpenGL Rendering Context is not fully setup.
    Use this context if you need to monitor when the Dynamic Map is still in a process of fetching tiles for rendering the display.

Product Availability

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

See Also:
Serialized Form

Field Summary
Fields inherited from class java.util.EventObject
Constructor Summary
IDynamicMapEventsBeforeDynamicDrawEvent(Object source)
Method Summary
 IDisplay getDisplay()
 IDynamicDisplay getDynamicDisplay()
 int getDynamicMapDrawPhase()
 void init(int dynamicMapDrawPhase, IDisplay display, IDynamicDisplay dynamicDisplay)
Methods inherited from class java.util.EventObject
getSource, toString
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail


public IDynamicMapEventsBeforeDynamicDrawEvent(Object source)
Method Detail


public void init(int dynamicMapDrawPhase,
                 IDisplay display,
                 IDynamicDisplay dynamicDisplay)


public final int getDynamicMapDrawPhase()


public final IDisplay getDisplay()


public final IDynamicDisplay getDynamicDisplay()