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


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

IDynamicCompoundMarker Interface

Provides access to dynamic compound marker. Note: the IDynamicCompoundMarker interface has been superseded byIDynamicCompoundMarker2. Please consider using the more recent version.

Product Availability

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

Description

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

Members

Description
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 GetMarkerToTextOffset The offset of the text from the marker in pixels.
Method SetMarkerToTextOffset The offset of the text from the marker in pixels.

CoClasses that implement IDynamicCompoundMarker

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.

The DrawCompondMarkerN methods are drawing a Marker with a combination of 1, 2, 4, 8, or 10 text strings around it.

These methods are using a location in Map Coordinates.

The following diagram shows the layout of the DrawCompoundMarker10 method:

 

DrawCompoundMarker10

.NET Snippets

Draw Compound Marker on Dynamic Display

.NET Samples

Dynamic display layer (Code Files: MyDynamicLayerClass)