com.esri.arcgis.display
Class IDynamicCompoundMarkerProxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.display.IDynamicCompoundMarkerProxy

All Implemented Interfaces:

IDynamicCompoundMarker, Externalizable, Serializable

Direct Known Subclasses:

IDynamicCompoundMarker2Proxy

public class IDynamicCompoundMarkerProxy
extends com.esri.arcgis.interop.Dispatch
implements IDynamicCompoundMarker, Serializable

Provides access to dynamic compound marker.

Superseded By

IDynamicCompoundMarker2

Description

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

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:

Product Availability

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

See Also:

Serialized Form

Field Summary

boolean

noncastable

Fields inherited from class com.esri.arcgis.interop.Dispatch

DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, objRef

Constructor Summary

	IDynamicCompoundMarkerProxy()
	IDynamicCompoundMarkerProxy(Object obj)
protected	IDynamicCompoundMarkerProxy(Object obj, String iid)

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
void	drawCompoundMarker1(IPoint point, String textTop) Draws specified point on the dynamic display with one string above it.
void	drawCompoundMarker10(IPoint point, String textTop, String textBottom, String textLeft1, String textLeft2, String textLeft3, String textLeft4, String textRight1, String textRight2, String textRight3, String textRight4) 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).
void	drawCompoundMarker2(IPoint point, String textTop, String textBottom) Draws specified point on the dynamic display with a string above and below.
void	drawCompoundMarker4(IPoint point, String textTop, String textBottom, String textLeft, String textRight) Draws specified point on the dynamic display with a text string on each side of the marker (top, bottom, left and right).
void	drawCompoundMarker6(IPoint point, String textTop, String textBottom, String textLeft1, String textLeft2, String textRight1, String textRight2) 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).
void	drawCompoundMarker8(IPoint point, String textTop, String textBottom, String textLeft1, String textLeft2, String textLeft3, String textRight1, String textRight2, String textRight3) 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).
void	getMarkerToTextOffset(float[] xOffset, float[] yOffset) The offset of the text from the marker in pixels.
void	removeListener(String iidStr, Object theListener)
void	setMarkerToTextOffset(float xOffset, float yOffset) The offset of the text from the marker in pixels.

Methods inherited from class com.esri.arcgis.interop.Dispatch

bindUsingMoniker, constructVtblPosTable, convertToNative, cookieForListener, createDispatch, createObjrefMonikerDisplayName, equals, getActiveObject, getActiveObject, getDefaultProperty, getDispatchIdOfName, getLastErrorCode, getMtsObjectContext, getObjRef, getPropertyByName, getPropertyByName, getVtblPos, hashCode, initDispatch, invoke, invokeMethodByName, invokeMethodByName, invokeMethodByName, invokePropertyGetByName, invokePropertyPutByName, invokePropertyPutByRefByName, isNativeMode, isObjRef, optimizedVtblInvoke, queryInterface, readExternal, release, setNativeMode, setPropertyByName, toString, vtblInvoke, writeExternal

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

noncastable

public boolean noncastable

Constructor Detail

IDynamicCompoundMarkerProxy

public IDynamicCompoundMarkerProxy()

IDynamicCompoundMarkerProxy

public IDynamicCompoundMarkerProxy(Object obj)
                            throws IOException

Throws:

IOException

IDynamicCompoundMarkerProxy

protected IDynamicCompoundMarkerProxy(Object obj,
                                      String iid)
                               throws IOException

Throws:

IOException

Method Detail

addListener

public void addListener(String iidStr,
                        Object theListener,
                        Object theSource)
                 throws IOException

Overrides:

addListener in class com.esri.arcgis.interop.Dispatch

Throws:

IOException

removeListener

public void removeListener(String iidStr,
                           Object theListener)
                    throws IOException

Overrides:

removeListener in class com.esri.arcgis.interop.Dispatch

Throws:

IOException

getMarkerToTextOffset

public void getMarkerToTextOffset(float[] xOffset,
                                  float[] yOffset)
                           throws IOException,
                                  AutomationException

The offset of the text from the marker in pixels.

Remarks

Offset is the distance between the marker and the text labels.
X refers to the left and right offsets. Y refers to the top and bottom offsets.

Product Availability

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

Specified by:

getMarkerToTextOffset in interface IDynamicCompoundMarker

Parameters:

xOffset - The xOffset (in/out: use single element array)

yOffset - The yOffset (in/out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setMarkerToTextOffset

public void setMarkerToTextOffset(float xOffset,
                                  float yOffset)
                           throws IOException,
                                  AutomationException

The offset of the text from the marker in pixels.

Remarks

Offset is the distance between the marker and the text labels.
X refers to the left and right offsets. Y refers to the top and bottom offsets.

Product Availability

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

Specified by:

setMarkerToTextOffset in interface IDynamicCompoundMarker

Parameters:

xOffset - The xOffset (in)

yOffset - The yOffset (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

drawCompoundMarker1

public void drawCompoundMarker1(IPoint point,
                                String textTop)
                         throws IOException,
                                AutomationException

Draws specified point on the dynamic display with one string above it.

Remarks

Draws a marker with a text label on top

Product Availability

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

Specified by:

drawCompoundMarker1 in interface IDynamicCompoundMarker

Parameters:

point - A reference to a com.esri.arcgis.geometry.IPoint (in)

textTop - The textTop (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

drawCompoundMarker2

public void drawCompoundMarker2(IPoint point,
                                String textTop,
                                String textBottom)
                         throws IOException,
                                AutomationException

Draws specified point on the dynamic display with a string above and below.

Remarks

Draws a marker with 2 text labels: 1-top and 1-bottom

Product Availability

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

Specified by:

drawCompoundMarker2 in interface IDynamicCompoundMarker

Parameters:

point - A reference to a com.esri.arcgis.geometry.IPoint (in)

textTop - The textTop (in)

textBottom - The textBottom (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

drawCompoundMarker4

public void drawCompoundMarker4(IPoint point,
                                String textTop,
                                String textBottom,
                                String textLeft,
                                String textRight)
                         throws IOException,
                                AutomationException

Draws specified point on the dynamic display with a text string on each side of the marker (top, bottom, left and right).

Remarks

Draws a marker with 4 text labels: 1-top, 1-bottom, 1-left, 1-right

Product Availability

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

Specified by:

drawCompoundMarker4 in interface IDynamicCompoundMarker

Parameters:

point - A reference to a com.esri.arcgis.geometry.IPoint (in)

textTop - The textTop (in)

textBottom - The textBottom (in)

textLeft - The textLeft (in)

textRight - The textRight (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

drawCompoundMarker6

public void drawCompoundMarker6(IPoint point,
                                String textTop,
                                String textBottom,
                                String textLeft1,
                                String textLeft2,
                                String textRight1,
                                String textRight2)
                         throws IOException,
                                AutomationException

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).

Remarks

Draws a marker with 6 text labels: 1-top, 1-bottom, 2-left, 2-right

Product Availability

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

Specified by:

drawCompoundMarker6 in interface IDynamicCompoundMarker

Parameters:

point - A reference to a com.esri.arcgis.geometry.IPoint (in)

textTop - The textTop (in)

textBottom - The textBottom (in)

textLeft1 - The textLeft1 (in)

textLeft2 - The textLeft2 (in)

textRight1 - The textRight1 (in)

textRight2 - The textRight2 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

drawCompoundMarker8

public void drawCompoundMarker8(IPoint point,
                                String textTop,
                                String textBottom,
                                String textLeft1,
                                String textLeft2,
                                String textLeft3,
                                String textRight1,
                                String textRight2,
                                String textRight3)
                         throws IOException,
                                AutomationException

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).

Remarks

Draws a marker with 8 text labels: 1-top, 1-bottom, 3-left, 3-right

Product Availability

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

Specified by:

drawCompoundMarker8 in interface IDynamicCompoundMarker

Parameters:

point - A reference to a com.esri.arcgis.geometry.IPoint (in)

textTop - The textTop (in)

textBottom - The textBottom (in)

textLeft1 - The textLeft1 (in)

textLeft2 - The textLeft2 (in)

textLeft3 - The textLeft3 (in)

textRight1 - The textRight1 (in)

textRight2 - The textRight2 (in)

textRight3 - The textRight3 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

drawCompoundMarker10

public void drawCompoundMarker10(IPoint point,
                                 String textTop,
                                 String textBottom,
                                 String textLeft1,
                                 String textLeft2,
                                 String textLeft3,
                                 String textLeft4,
                                 String textRight1,
                                 String textRight2,
                                 String textRight3,
                                 String textRight4)
                          throws IOException,
                                 AutomationException

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).

Remarks

Draws a marker with 10 text labels: 1-top, 1-bottom, 4-left, 4-right

Product Availability

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

Specified by:

drawCompoundMarker10 in interface IDynamicCompoundMarker

Parameters:

point - A reference to a com.esri.arcgis.geometry.IPoint (in)

textTop - The textTop (in)

textBottom - The textBottom (in)

textLeft1 - The textLeft1 (in)

textLeft2 - The textLeft2 (in)

textLeft3 - The textLeft3 (in)

textLeft4 - The textLeft4 (in)

textRight1 - The textRight1 (in)

textRight2 - The textRight2 (in)

textRight3 - The textRight3 (in)

textRight4 - The textRight4 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.