ArcObjects Library Reference (Display)  

IDynamicDisplay Interface

Provides access to Dynamic Display.

Product Availability

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

Description

IDynamicDisplay interface gives access to drawing methods that render dynamic items using map coordinates, as well as access to an instance of the Dynamic Glyph Factory object. The Dynamic Glyph Factory object is a singleton object, which is used to create and delete dynamic glyphs and then can be used with the dynamic symbols in order to render the Dynamic items.

Members

Description
Method DrawLine Draws a line between the specified points on the dynamic display.
Method DrawMarker Draws a marker at the specified point on the dynamic display.
Method DrawMultipleLines Draws specified lines on the dynamic display.
Method DrawMultipleMarkers Draws a marker at the specified points on the dynamic display.
Method DrawPolygon Draws specified polygon with fill and line on the dynamic display.
Method DrawPolyline Draws specified polyline on the dynamic display.
Method DrawRectangle Draws specified rectangle with fill and line on the dynamic display.
Method DrawText Draws text at the specified point on the dynamic display.
Read-only property DynamicGlyphFactory Retrieves the dynamic glyph factory.

CoClasses that implement IDynamicDisplay

CoClasses and Classes Description
DynamicDisplay (esriCarto) Dynamic display class, used by the dynamic map.

Remarks

The IDynamicDisplay interface is passed in to the callback draw methods: IDynamicLayer.DrawDynamicLayer, IDynamicMapEvents.BeforeDynamicDraw, and IDynamicMapEvents.AfterDynamicDraw.

 

The drawing methods can only be used in one of the callback draw methods with the following specific context:

 

  1. In the IDynamicLayer.DrawDynamicLayer method.
    It is recommended to use the DynamicGlyphFactory in the esriDynamicDrawPhase.esriDDPImmediate dynamic-draw-phase.
  2. IDynamicMapEvents.AfterDynamicDraw method (event handler).
    Only with the dynamic-map-draw-phase esriDynamicMapDrawPhase.esriDMDPDynamicLayers.
  3. IDynamicMapEvents.BeforeDynamicDraw method (event handler).
    Only with the dynamic-map-draw-phase esriDynamicMapDrawPhase.esriDMDPDynamicLayers.

 

Any usage of the DynamicDisplay drawing API (or OpenGL API) in any other context will result in an unknown behavior.

.NET Snippets

Draw Line on Dynamic Display | Draw Compound Marker on Dynamic Display

.NET Samples

Dynamic logo (Code Files: DynamicLogo) | Dynamic display animated zoom (Code Files: AnimatedZoomInTool AnimatedZoomOutTool) | Dynamic biking (Code Files: DynamicBikingCmd) | Dynamic display—tracking dynamic object (Code Files: TrackObject)

.NET Related Topics

Best practices for using dynamic display | Getting started with dynamic display | How to plug in dynamic drawing