ArcObjects Library Reference (Display)  

IDynamicDrawScreen Interface

Provides access to Dynamic Screen Draw.

Product Availability

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

Description

The IDynamicScreenDisplay interface gives access to the drawing methods that render dynamic items using screen (pixel) coordinates.

Members

Description
Method DrawScreenLine Draws a line between the specified points on the screen.
Method DrawScreenMarker Draws a marker at the specified point on the screen.
Method DrawScreenMultipleLines Draws specified lines on the screen.
Method DrawScreenMultipleMarkers Draws a marker at the specified points on the screen.
Method DrawScreenPolygon Draws specified polygon with fill and line on the screen.
Method DrawScreenPolyline Draws specified polyline on the screen.
Method DrawScreenRectangle Draws specified rectangle with fill and line on the screen.
Method DrawScreenText Draws text at the specified point on the screen.

CoClasses that implement IDynamicDrawScreen

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

Remarks

Use this interface to draw items when you need to specify the item’s coordinates in screen units (pixels) rather than in map units. The origin of the screen is the lower left corner of the screen, while x values are growing towards the right, and y values are growing towards the top.

The IDynamicScreenDisplay interface can be retrieved by casting from the IDynamicDisplay interface that 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.