IDynamicDrawScreen Interface

Provides access to Dynamic Screen Draw.

Product Availability

Description

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

Members

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

CoClasses that implement IDynamicDrawScreen

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.

.NET Snippets

.NET Samples