This document is archived and information here might be outdated.  Recommended version.


IDynamicCompoundMarker2 Interface (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (Display)  

IDynamicCompoundMarker2 Interface

Provides access to Dynamic Screen Draw.

Product Availability

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

Description

This interface is new at ArcGIS 9.3. It supersedes IDynamicCompoundMarker.

IDynamicCompoundMarker2 is a helper interface that optimizes the rendering of a marker along with some text labels around it.

Members

Description
Method DrawArrayMarker Draws a marker in a specific point on the map with text matricies around it.
Method DrawCompoundMarker1 Draws specified point on the dynamic display with one string above it.
Method DrawCompoundMarker10 Draws specified point on the dynamic display with one string on the top of the marker, one string on the bottom and four strings on each side of the marker (left and right).
Method DrawCompoundMarker2 Draws specified point on the dynamic display with a string above and below.
Method DrawCompoundMarker4 Draws specified point on the dynamic display with a text string on each side of the marker (top, bottom, left and right).
Method DrawCompoundMarker6 Draws specified point on the dynamic display with one string on the top of the marker, one string on the bottom and two strings on each side of the marker (left and right).
Method DrawCompoundMarker8 Draws specified point on the dynamic display with one string on the top of the marker, one string on the bottom and three strings on each side of the marker (left and right).
Method DrawScreenArrayMarker Draws a marker in a specific point on the screen with text matricies around it.
Method GetMarkerToTextOffset The offset of the text from the marker in pixels.
Method GetMarkerToTextOffset2 Indicates the offset of the text from the marker on each direction.
Method GetTextSpacing Indicates the spacing between each two adjacent text boxes.
Method SetMarkerToTextOffset The offset of the text from the marker in pixels.
Method SetMarkerToTextOffset2 Indicates the offset of the text from the marker on each direction.
Method SetTextSpacing Indicates the spacing between each two adjacent text boxes.
Read/write property TextAutoAdjust Indicates whether the text boxes are to be auto ajdusted.

Inherited Interfaces

Interfaces Description
IDynamicCompoundMarker Provides access to dynamic compound marker.

CoClasses that implement IDynamicCompoundMarker2

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

Remarks

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.

Use the DrawArrayMarker and DrawScreenArrayMarker methods in order to draw markers along with text labels around them. These methods can be used in order to draw an array of text labels column on each of the five marker’s regions: center, left, right, top, bottom:

ArrayMarker

.NET Samples

Dynamic biking (Code Files: DynamicBikingCmd) | RSS weather layer (Code Files: RSSWeatherLayerClass)