DynamicDisplay (ArcObjects Java API)

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.esri.arcgis.carto
Class DynamicDisplay

java.lang.Object
  com.esri.arcgis.carto.DynamicDisplay

All Implemented Interfaces:: IActiveViewEvents, IConnectionPointContainer, IDynamicCompoundMarker, IDynamicCompoundMarker2, IDynamicDisplay, IDynamicDisplay2, IDynamicDrawScreen, IDynamicGlyphFactory, IDynamicGlyphFactory2, IDynamicSymbolProperties, IDynamicSymbolProperties2, ITransformEvents, com.esri.arcgis.interop.RemoteObjRef, Serializable, EventListener

public class DynamicDisplay
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, IDynamicDisplay, IDynamicDisplay2, IDynamicDrawScreen, IDynamicGlyphFactory, IDynamicGlyphFactory2, IDynamicSymbolProperties, IDynamicSymbolProperties2, IDynamicCompoundMarker, IDynamicCompoundMarker2, IConnectionPointContainer, IActiveViewEvents, ITransformEvents
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, IDynamicDisplay, IDynamicDisplay2, IDynamicDrawScreen, IDynamicGlyphFactory, IDynamicGlyphFactory2, IDynamicSymbolProperties, IDynamicSymbolProperties2, IDynamicCompoundMarker, IDynamicCompoundMarker2, IConnectionPointContainer, IActiveViewEvents, ITransformEvents

Dynamic display class, used by the dynamic map.

Product Availability

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

See Also:: Serialized Form

Constructor Summary
`DynamicDisplay(Object obj)` Construct a DynamicDisplay using a reference to such an object returned from ArcGIS Engine or Server.

Method Summary
`void`	`afterDraw(IActiveViewEventsAfterDrawEvent theEvent)` Fired after the specified phase is drawn.
`void`	`afterItemDraw(IActiveViewEventsAfterItemDrawEvent theEvent)` Fired after an individual view item is drawn.
`void`	`boundsUpdated(ITransformEventsBoundsUpdatedEvent theEvent)` Notifies clients when the bounds is updated.
`void`	`contentsChanged(IActiveViewEventsContentsChangedEvent theEvent)` Fired when the contents of the view changes.
`void`	`contentsCleared(IActiveViewEventsContentsClearedEvent theEvent)` Fired when the contents of the view is cleared.
`IDynamicGlyph`	`createDynamicGlyph(ISymbol symbol)` Creates a dynamic glyph from a symbol.
`IDynamicGlyph`	`createDynamicGlyphFromBitmap(int glyphType, int hBmp, boolean preserveAlphaChannel, IColor transparencyColor)` Create a dynamic glyph from a bitmap handle.
`IDynamicGlyph`	`createDynamicGlyphFromFile(int glyphType, String fileName, IColor transparencyColor)` Creates a dynamic glyph from a file.
`void`	`deleteDynamicDrawing(IDynamicDrawing pDynamicDrawing)` Delete a dynamic drawing.
`void`	`deleteDynamicGlyph(IDynamicGlyph glyph)` Deletes the dynamic glyph's resource.
`void`	`deviceFrameUpdated(ITransformEventsDeviceFrameUpdatedEvent theEvent)` Notifies clients when the device frame is updated.
`void`	`drawArrayMarker(IPoint point, String[] textCenter, String[] textLeft, String[] textRight, String[] textTop, String[] textBottom)` Draws a marker in a specific point on the map with text matricies around it.
`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`	`drawLine(IPoint startPoint, IPoint endPoint)` Draws a line between the specified points on the dynamic display.
`void`	`drawMarker(IPoint point)` Draws a marker at the specified point on the dynamic display.
`void`	`drawMultipleLines(IPointCollection pointCollection)` Draws specified lines on the dynamic display.
`void`	`drawMultipleMarkers(IPointCollection pointCollection)` Draws a marker at the specified points on the dynamic display.
`void`	`drawPolygon(IPointCollection pointCollection)` Draws specified polygon with fill and line on the dynamic display.
`void`	`drawPolyline(IPointCollection pointCollection)` Draws specified polyline on the dynamic display.
`void`	`drawRectangle(IEnvelope envelope)` Draws specified rectangle with fill and line on the dynamic display.
`void`	`drawScreenArrayMarker(IPoint point, String[] textCenter, String[] textLeft, String[] textRight, String[] textTop, String[] textBottom)` Draws a marker in a specific point on the screen with text matricies around it.
`void`	`drawScreenLine(IPoint startPoint, IPoint endPoint)` Draws a line between the specified points on the screen.
`void`	`drawScreenMarker(IPoint point)` Draws a marker at the specified point on the screen.
`void`	`drawScreenMultipleLines(IPointCollection pointCollection)` Draws specified lines on the screen.
`void`	`drawScreenMultipleMarkers(IPointCollection pointCollection)` Draws a marker at the specified points on the screen.
`void`	`drawScreenPolygon(IPointCollection pointCollection)` Draws specified polygon with fill and line on the screen.
`void`	`drawScreenPolyline(IPointCollection pointCollection)` Draws specified polyline on the screen.
`void`	`drawScreenRectangle(IEnvelope envelope)` Draws specified rectangle with fill and line on the screen.
`void`	`drawScreenText(IPoint point, String text)` Draws text at the specified point on the screen.
`void`	`drawText(IPoint point, String text)` Draws text at the specified point on the dynamic display.
`void`	`enumConnectionPoints(IEnumConnectionPoints[] ppEnum)` enumConnectionPoints
`boolean`	`equals(Object o)` Compare this object with another
`void`	`findConnectionPoint(GUID riid, IConnectionPoint[] ppCP)` findConnectionPoint
`void`	`focusMapChanged(IActiveViewEventsFocusMapChangedEvent theEvent)` Fired when a new map is made active.
`void`	`getColor(int dynamicSymbolType, float[] red, float[] green, float[] blue, float[] alpha)` Indicates the color for the specified dynamic symbol.
`void`	`getCreatedDynamicGlyphSize(int glyphType, int[] sizeX, int[] sizeY)` Indicates the texture size of the created dynamic glyph.
`IDynamicGlyph`	`getDynamicGlyph(int dynamicSymbolType)` Indicates the dynamic glyph for the specified dynamic symbol.
`IDynamicGlyph`	`getDynamicGlyph(int groupId, int glyphType, int index)` Retrieves a dynamic glyph from a glyph group.
`IDynamicGlyphFactory`	`getDynamicGlyphFactory()` Retrieves the dynamic glyph factory.
`float`	`getHeading(int dynamicSymbolType)` Indicates the heading for the specified dynamic symbol, relative to the rotation alignment.
`void`	`getMarkerToTextOffset(float[] xOffset, float[] yOffset)` The offset of the text from the marker in pixels.
`void`	`getMarkerToTextOffset2(float[] markerToTop, float[] markerToBottom, float[] markerToLeft, float[] markerToRight)` Indicates the offset of the text from the marker on each direction.
`void`	`getOffset(int dynamicSymbolType, float[] offsetX, float[] offsetY)` Offsets the dynamic symbol.
`int`	`getRotationAlignment(int dynamicSymbolType)` Indicates the rotation alignment for the specified dynamic symbol.
`void`	`getScale(int dynamicSymbolType, float[] scaleX, float[] scaleY)` Scales the dynamic symbol.
`int`	`getSelectionIdentifier()` Allocate a unique index to be used with dynamic selection.
`int`	`getTextBoxHorizontalAlignment()` Indicates the text box horizontal alignment for the dynamic text symbol.
`void`	`getTextBoxMargins(float[] left, float[] top, float[] right, float[] bottom)` Indicates the text box margins for the dynamic text symbol.
`float`	`getTextCharacterSpacing()` Indicates an additional space that is added to each character beyond what is defined by its character box in the TextGlyph.
`int`	`getTextHorizontalAlignment()` Indicates the horizontal alignment for the dynamic text symbol.
`float`	`getTextLeading()` Indicates the text leading for the dynamic text symbol.
`void`	`getTextSize(String text, float[] sizeX, float[] sizeY)` The text size in pixel screen coordinates.
`void`	`getTextSpacing(float[] textSpacingX, float[] textSpacingY)` Indicates the spacing between each two adjacent text boxes.
`int`	`getTextVerticalAlignment()` Indicates the vertical alignment for the dynamic text symbol.
`float`	`getTextWordSpacing()` Indicates an additional space that is added between words of the text string.
`int`	`hashCode()` the hashcode for this object
`void`	`init(IScreenDisplay screenDisplay)` Initialize the dynamic glyph factory.
`void`	`insertDynamicDrawing(IDynamicDrawing pDynamicDrawing, int lPosition)` Add a dynamic drawing to the display at the specified Z order.
`boolean`	`isLineContinuePattern()` Indicates whether the line pattern is continued or restarted, for multi parts lines drawing.
`boolean`	`isSmooth(int dynamicSymbolType)` Indicates whether the specified dynamic symbol will be smooth.
`boolean`	`isSupportStaticDrawing()` Indicates whether display supports static drawing such as lables and graphics.
`boolean`	`isTextAutoAdjust()` Indicates whether the text boxes are to be auto ajdusted.
`boolean`	`isTextBoxUseDynamicFillSymbol()` Indicates whether to use the dynamic fill symbol when drawing the text.
`boolean`	`isTextBoxUseDynamicLineSymbol()` Indicates whether to use the dynamic line symbol when drawing the text.
`boolean`	`isTextRightToLeft()` Indicates whether the text is drawn from right to left for the dynamic text symbol.
`boolean`	`isUseReferenceScale(int dynamicSymbolType)` Indicates whether the specified dynamic symbol will conform to map reference scale.
`void`	`itemAdded(IActiveViewEventsItemAddedEvent theEvent)` Fired when an item is added to the view.
`void`	`itemDeleted(IActiveViewEventsItemDeletedEvent theEvent)` Fired when an item is deleted from the view.
`void`	`itemReordered(IActiveViewEventsItemReorderedEvent theEvent)` Fired when a view item is reordered.
`int`	`loadDynamicGlyphsGroup(String fileName)` Loads a dynamic glyph group from files.
`IArray`	`locate(int xView, int yView, int selectionMode, Object data)` Locate named objects in the display.
`void`	`resolutionUpdated(ITransformEventsResolutionUpdatedEvent theEvent)` Notifies clients when the resolution is updated.
`void`	`rotationUpdated(ITransformEventsRotationUpdatedEvent theEvent)` Notifies clients when the rotation angle is updated.
`void`	`selectionChanged(IActiveViewEventsSelectionChangedEvent theEvent)` Call this function to fire the selection changed event.
`void`	`setColor(int dynamicSymbolType, float red, float green, float blue, float alpha)` Indicates the color for the specified dynamic symbol.
`void`	`setCreatedDynamicGlyphSize(int glyphType, int sizeX, int sizeY)` Indicates the texture size of the created dynamic glyph.
`void`	`setDynamicGlyphByRef(int dynamicSymbolType, IDynamicGlyph dynamicGlyph)` Indicates the dynamic glyph for the specified dynamic symbol.
`void`	`setHeading(int dynamicSymbolType, float heading)` Indicates the heading for the specified dynamic symbol, relative to the rotation alignment.
`void`	`setLineContinuePattern(boolean continuePattern)` Indicates whether the line pattern is continued or restarted, for multi parts lines drawing.
`void`	`setMarkerToTextOffset(float xOffset, float yOffset)` The offset of the text from the marker in pixels.
`void`	`setMarkerToTextOffset2(float markerToTop, float markerToBottom, float markerToLeft, float markerToRight)` Indicates the offset of the text from the marker on each direction.
`void`	`setOffset(int dynamicSymbolType, float offsetX, float offsetY)` Offsets the dynamic symbol.
`void`	`setRotationAlignment(int dynamicSymbolType, int dynamicSymbolRotationAlignment)` Indicates the rotation alignment for the specified dynamic symbol.
`void`	`setScale(int dynamicSymbolType, float scaleX, float scaleY)` Scales the dynamic symbol.
`void`	`setSmooth(int dynamicSymbolType, boolean smooth)` Indicates whether the specified dynamic symbol will be smooth.
`void`	`setSupportStaticDrawing(boolean staticDrawing)` Indicates whether display supports static drawing such as lables and graphics.
`void`	`setTextAutoAdjust(boolean autoAdjust)` Indicates whether the text boxes are to be auto ajdusted.
`void`	`setTextBoxHorizontalAlignment(int textBoxHorizontalAlignment)` Indicates the text box horizontal alignment for the dynamic text symbol.
`void`	`setTextBoxMargins(float left, float top, float right, float bottom)` Indicates the text box margins for the dynamic text symbol.
`void`	`setTextBoxUseDynamicFillSymbol(boolean use)` Indicates whether to use the dynamic fill symbol when drawing the text.
`void`	`setTextBoxUseDynamicLineSymbol(boolean use)` Indicates whether to use the dynamic line symbol when drawing the text.
`void`	`setTextCharacterSpacing(float characterSpacing)` Indicates an additional space that is added to each character beyond what is defined by its character box in the TextGlyph.
`void`	`setTextHorizontalAlignment(int horizontalAlignment)` Indicates the horizontal alignment for the dynamic text symbol.
`void`	`setTextLeading(float leading)` Indicates the text leading for the dynamic text symbol.
`void`	`setTextRightToLeft(boolean rightToLeft)` Indicates whether the text is drawn from right to left for the dynamic text symbol.
`void`	`setTextSpacing(float textSpacingX, float textSpacingY)` Indicates the spacing between each two adjacent text boxes.
`void`	`setTextVerticalAlignment(int verticalAlignment)` Indicates the vertical alignment for the dynamic text symbol.
`void`	`setTextWordSpacing(float wordSpacing)` Indicates an additional space that is added between words of the text string.
`void`	`setUseReferenceScale(int dynamicSymbolType, boolean useReferenceScale)` Indicates whether the specified dynamic symbol will conform to map reference scale.
`void`	`spatialReferenceChanged(IActiveViewEventsSpatialReferenceChangedEvent theEvent)` Fired when the spatial reference is changed.
`void`	`unitsUpdated(ITransformEventsUnitsUpdatedEvent theEvent)` Notifies clients when the units are updated.
`void`	`unloadDynamicGlyphsGroup(int groupId)` Unloads a dynamic glyph group, and any corresponding resources.
`void`	`viewRefreshed(IActiveViewEventsViewRefreshedEvent theEvent)` Fired when view is refreshed before draw happens.
`void`	`visibleBoundsUpdated(ITransformEventsVisibleBoundsUpdatedEvent theEvent)` Notifies clients when the visible bounds is updated.

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait`

Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef
`getJintegraDispatch, release`

Constructor Detail

DynamicDisplay

public DynamicDisplay(Object obj)
               throws IOException

Construct a DynamicDisplay using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to DynamicDisplay.
Casting to this class from the return value of a method will not work, as this class represents an abstract class in ArcObjects.

   * 
DynamicDisplay o = (DynamicDisplay)obj; // will not work 

 
DynamicDisplay o = new DynamicDisplay(obj); // Use this constructor instead

* @param obj an object returned from ArcGIS Engine or Server

Throws:: IOException - if there are interop problems DynamicDisplay theDynamicDisplay = (DynamicDisplay) obj;

Method Detail

equals

public boolean equals(Object o)

Compare this object with another

Overrides:: equals in class Object

hashCode

public int hashCode()

the hashcode for this object

Overrides:: hashCode in class Object

getDynamicGlyphFactory

public IDynamicGlyphFactory getDynamicGlyphFactory()
                                            throws IOException,
                                                   AutomationException

Retrieves the dynamic glyph factory.

Remarks

Use the dynamic glyph factory object in order to create and delete dynamic glyphs. The dynamic glyphs can be used with the Dynamic Symbols in order to render Dynamic Items.

The Dynamic Glyphs Factory is a singleton object; therefore you can always co-create it in order to use it to create and delete dynamic glyphs.
Performance wise, it is preferable to create the dynamic glyphs in the context of the IDynamicLayer�s DrawDynamicLayer method, in the esriDDPImmediate dynamic-draw-phase, or in the context of the IDynamicMapEvents BeofreDynamicDraw method, in the esriDMDPDynamicLayers dynamic-map-draw-phase, while casting the passed in IDynamicDisplay interface to IDynamicGlyphFactory.

Product Availability

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

Specified by:: getDynamicGlyphFactory in interface IDynamicDisplay

Returns:: A reference to a com.esri.arcgis.display.IDynamicGlyphFactory
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawMultipleMarkers

public void drawMultipleMarkers(IPointCollection pointCollection)
                         throws IOException,
                                AutomationException

Draws a marker at the specified points on the dynamic display.

Remarks

The markers will be rendered according to the current Dynamic Marker Symbol attributes, as described in esriDynamicSymbolType constants.

Using this method is useful when you need to draw multiple markers that look the same in different locations, for example drawing indication markers on a polyline's or a polygon's vertices.

Product Availability

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

In order to manage your dynamic items you should keep them in arrays of WKSPoint and have an instance of a Multipoint class (as IPointCollection). In order efficiently update the items you should be using IGeometryBridge2 interface

Specified by:: drawMultipleMarkers in interface IDynamicDisplay

Parameters:: pointCollection - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawMarker

public void drawMarker(IPoint point)
                throws IOException,
                       AutomationException

Draws a marker at the specified point on the dynamic display.

Remarks

The marker will be rendered according to the current Dynamic Marker Symbol attributes, as described in esriDynamicSymbolType constants.

Product Availability

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

Specified by:: drawMarker in interface IDynamicDisplay

Parameters:: point - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawPolygon

public void drawPolygon(IPointCollection pointCollection)
                 throws IOException,
                        AutomationException

Draws specified polygon with fill and line on the dynamic display.

Remarks

The fill will be rendered according to the current Dynamic Fill Symbol attributes, as described inesriDynamicSymbolType, and the lines will be rendered according to the current Dynamic Line Symbol attributes, as described in esriDynamicSymbolType

Product Availability

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

In order to manage your dynamic polygon, you should keep it as an array of WKSPoint (do not forget to copy the first point at the end of the array) and have an instance of a Polygon geometry class in your application (as IPointCollection). In order efficiently update the polygon geometry you should be using IGeometryBridge2 interface.

Specified by:: drawPolygon in interface IDynamicDisplay

Parameters:: pointCollection - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawMultipleLines

public void drawMultipleLines(IPointCollection pointCollection)
                       throws IOException,
                              AutomationException

Draws specified lines on the dynamic display.

Remarks

The lines will be rendered according to the current Dynamc Line Symbol attributes, as described in esriDynamicSymbolType constants.

Product Availability

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

Specified by:: drawMultipleLines in interface IDynamicDisplay

Parameters:: pointCollection - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawLine

public void drawLine(IPoint startPoint,
                     IPoint endPoint)
              throws IOException,
                     AutomationException

Draws a line between the specified points on the dynamic display.

Remarks

The line will be rendered according to the current Dynamic Line Symbol attributes, as described in esriDynamicSymbolType constants.

Product Availability

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

Specified by:: drawLine in interface IDynamicDisplay

Parameters:: startPoint - A reference to a com.esri.arcgis.geometry.IPoint (in); endPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawPolyline

public void drawPolyline(IPointCollection pointCollection)
                  throws IOException,
                         AutomationException

Draws specified polyline on the dynamic display.

Remarks

The lines will be rendered according to the current Dynamic Line Symbol attributes, as described in esriDynamicSymbolType constants.

Product Availability

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

In order to manage your dynamic polyline, you should keep it as an array of WKSPoint and have an instance of a Polyline geometry class in your application (as IPointCollection). In order efficiently update the polyline geometry you should be using IGeometryBridge2 interface

Specified by:: drawPolyline in interface IDynamicDisplay

Parameters:: pointCollection - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawRectangle

public void drawRectangle(IEnvelope envelope)
                   throws IOException,
                          AutomationException

Draws specified rectangle with fill and line on the dynamic display.

Remarks

Similar to the DrawPolygon method, the fill will be rendered according to the current Dynamic Fill Symbol attributes, and the lines will be rendered according to the current Dynamic Line Symbol attributes, as described in esriDynamicSymbolType constants.

Product Availability

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

Specified by:: drawRectangle in interface IDynamicDisplay

Parameters:: envelope - A reference to a com.esri.arcgis.geometry.IEnvelope (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawText

public void drawText(IPoint point,
                     String text)
              throws IOException,
                     AutomationException

Draws text at the specified point on the dynamic display.

Remarks

The text will be rendered according to the current Dynamic Text Symbol attributes, as described in esriDynamicSymbolType constants.

Using the Dynamic Text Symbol, you can set the text to have a text box that will use the Dynamic Fill Symbol for Background fill, and the Dynamic Line Symbol for outline. Please refer to IDynamicSymbolProperties2.TextBoxUseDynamicFillSymbol and IDynamicSymbolProperties2.TextBoxUseDynamicLineSymbol boolean properties.

Product Availability

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

Specified by:: drawText in interface IDynamicDisplay

Parameters:: point - A reference to a com.esri.arcgis.geometry.IPoint (in); text - The text (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

isSupportStaticDrawing

public boolean isSupportStaticDrawing()
                               throws IOException,
                                      AutomationException

Indicates whether display supports static drawing such as lables and graphics.

Product Availability

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

Specified by:: isSupportStaticDrawing in interface IDynamicDisplay2

Returns:: The staticDrawing
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setSupportStaticDrawing

public void setSupportStaticDrawing(boolean staticDrawing)
                             throws IOException,
                                    AutomationException

Indicates whether display supports static drawing such as lables and graphics.

Product Availability

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

Specified by:: setSupportStaticDrawing in interface IDynamicDisplay2

Parameters:: staticDrawing - The staticDrawing (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

locate

public IArray locate(int xView,
                     int yView,
                     int selectionMode,
                     Object data)
              throws IOException,
                     AutomationException

Locate named objects in the display. Provides a mechanism for hit-test, selection etc.

Product Availability

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

Specified by:: locate in interface IDynamicDisplay2

Parameters:: xView - The xView (in); yView - The yView (in); selectionMode - A com.esri.arcgis.display.esriDynamicSelectionMode constant (in); data - A reference to another Object (IUnknown) (in)
Returns:: A reference to a com.esri.arcgis.system.IArray
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getSelectionIdentifier

public int getSelectionIdentifier()
                           throws IOException,
                                  AutomationException

Allocate a unique index to be used with dynamic selection.

Product Availability

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

Specified by:: getSelectionIdentifier in interface IDynamicDisplay2

Returns:: The identifier
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

insertDynamicDrawing

public void insertDynamicDrawing(IDynamicDrawing pDynamicDrawing,
                                 int lPosition)
                          throws IOException,
                                 AutomationException

Add a dynamic drawing to the display at the specified Z order.

Product Availability

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

Specified by:: insertDynamicDrawing in interface IDynamicDisplay2

Parameters:: pDynamicDrawing - A reference to a com.esri.arcgis.display.IDynamicDrawing (in); lPosition - The lPosition (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

deleteDynamicDrawing

public void deleteDynamicDrawing(IDynamicDrawing pDynamicDrawing)
                          throws IOException,
                                 AutomationException

Delete a dynamic drawing.

Product Availability

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

Specified by:: deleteDynamicDrawing in interface IDynamicDisplay2

Parameters:: pDynamicDrawing - A reference to a com.esri.arcgis.display.IDynamicDrawing (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawScreenMultipleMarkers

public void drawScreenMultipleMarkers(IPointCollection pointCollection)
                               throws IOException,
                                      AutomationException

Draws a marker at the specified points on the screen.

Remarks

The markers will be rendered according to the current Dynamic Marker Symbol attributes as described in esriDynamicSymbolType constants.

Using this method is useful when you need to draw multiple markers that looks the same, in different locations, for example drawing indication markers on a polyline�s or a polygon�s vertices.

Product Availability

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

Specified by:: drawScreenMultipleMarkers in interface IDynamicDrawScreen

Parameters:: pointCollection - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawScreenMarker

public void drawScreenMarker(IPoint point)
                      throws IOException,
                             AutomationException

Draws a marker at the specified point on the screen.

Remarks

The marker will be rendered according to the currentDynamic Marker Symbol attributes, as described in esriDynamicSymbolType constants.

Product Availability

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

Specified by:: drawScreenMarker in interface IDynamicDrawScreen

Parameters:: point - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawScreenPolygon

public void drawScreenPolygon(IPointCollection pointCollection)
                       throws IOException,
                              AutomationException

Draws specified polygon with fill and line on the screen.

Remarks

The fill will be rendered according to the current Dynamic Fill Symbol attributes, and the lines will be rendered according to the current Dynamic Line Symbol attributes as described in esriDynamicSymbolType constants.

Product Availability

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

Specified by:: drawScreenPolygon in interface IDynamicDrawScreen

Parameters:: pointCollection - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawScreenMultipleLines

public void drawScreenMultipleLines(IPointCollection pointCollection)
                             throws IOException,
                                    AutomationException

Draws specified lines on the screen.

Remarks

The lines will be rendered according to the current Dynamic Line Symbol attributes, as described in esriDynamicSymbolType constants.

Product Availability

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

Specified by:: drawScreenMultipleLines in interface IDynamicDrawScreen

Parameters:: pointCollection - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawScreenLine

public void drawScreenLine(IPoint startPoint,
                           IPoint endPoint)
                    throws IOException,
                           AutomationException

Draws a line between the specified points on the screen.

Remarks

The line will be rendered according to the current Dynamic Line Symbol attributes, as described in esriDynamicSymbolType constants.

Product Availability

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

Specified by:: drawScreenLine in interface IDynamicDrawScreen

Parameters:: startPoint - A reference to a com.esri.arcgis.geometry.IPoint (in); endPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawScreenPolyline

public void drawScreenPolyline(IPointCollection pointCollection)
                        throws IOException,
                               AutomationException

Draws specified polyline on the screen.

Remarks

The lines will be rendered according to the current Dynamic Line Symbol attributes as described in esriDynamicSymbolType constants.

Product Availability

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

Specified by:: drawScreenPolyline in interface IDynamicDrawScreen

Parameters:: pointCollection - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawScreenRectangle

public void drawScreenRectangle(IEnvelope envelope)
                         throws IOException,
                                AutomationException

Draws specified rectangle with fill and line on the screen.

Remarks

Similar to DrawPolygon method, the fill will be rendered according to the current Dynamic Fill Symbol attributes, and the lines will be rendered according to the current Dynamic Line Symbol attributes, as described in esriDynamicSymbolType constants.

Product Availability

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

Specified by:: drawScreenRectangle in interface IDynamicDrawScreen

Parameters:: envelope - A reference to a com.esri.arcgis.geometry.IEnvelope (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawScreenText

public void drawScreenText(IPoint point,
                           String text)
                    throws IOException,
                           AutomationException

Draws text at the specified point on the screen.

Remarks

The text will be rendered according to the current DynamicTextSymbol attributes.

Using the DynamicTextSymbol, you can set the text to have a text box that will use the DynamicFillSymbol for Background fill, and the DynamicLineSymbol for outline. Please refer to IDynamicSymbolProperties2.TextBoxUseDynamicFillSymbol and IDynamicSymbolProperties2.TextBoxUseDynamicLineSymbol boolean properties.

Product Availability

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

Specified by:: drawScreenText in interface IDynamicDrawScreen

Parameters:: point - A reference to a com.esri.arcgis.geometry.IPoint (in); text - The text (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

init

public void init(IScreenDisplay screenDisplay)
          throws IOException,
                 AutomationException

Initialize the dynamic glyph factory.

Remarks

This method should only be used after co-creating a Dynamic Glyph Factory. There is no need to init a Dynamic Glyph Factory that was retrieved from a Dynamic Display object.

Product Availability

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

Specified by:: init in interface IDynamicGlyphFactory

Parameters:: screenDisplay - A reference to a com.esri.arcgis.display.IScreenDisplay (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

createDynamicGlyph

public IDynamicGlyph createDynamicGlyph(ISymbol symbol)
                                 throws IOException,
                                        AutomationException

Creates a dynamic glyph from a symbol.

Remarks

For monochromatic symbols (symbols that consist of only one color and might even have fixed black pixels), it is advisable to set the Symbol color to white before passing it into the method. When rendering the Dynamic Symbol, using the Dynamic Glyph created using this method, you should then set the color to the desired color. That will result in coloring the white pixels to the desired color, while leaving the black colors black.

Product Availability

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

Specified by:: createDynamicGlyph in interface IDynamicGlyphFactory

Parameters:: symbol - A reference to a com.esri.arcgis.display.ISymbol (in)
Returns:: A reference to a com.esri.arcgis.display.IDynamicGlyph
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

deleteDynamicGlyph

public void deleteDynamicGlyph(IDynamicGlyph glyph)
                        throws IOException,
                               AutomationException

Deletes the dynamic glyph's resource.

Remarks

It is important to call this method in order to release the Dynamic Glyph�s resources. A Dynamic Glyph object that is destroyed without calling this method might result in memory leaks on the graphic card memory. Also, it is recommended to delete unused Dynamic Glyphs in order to free up Graphic Card memory.

Product Availability

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

Specified by:: deleteDynamicGlyph in interface IDynamicGlyphFactory

Parameters:: glyph - A reference to a com.esri.arcgis.display.IDynamicGlyph (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

createDynamicGlyphFromFile

public IDynamicGlyph createDynamicGlyphFromFile(int glyphType,
                                                String fileName,
                                                IColor transparencyColor)
                                         throws IOException,
                                                AutomationException

Creates a dynamic glyph from a file.

Remarks

Creates a dynamic glyph from an image file. If the image file consists of an alpha channel, the method will honor the alpha values in the alpha channel, otherwise the alpha values will be set to be opaque (255). If the transparency color is not NULL, each pixel that matches the transparencyColor parameter will be transparent (its alpha values in the glyph will be set to 0).

Product Availability

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

Specified by:: createDynamicGlyphFromFile in interface IDynamicGlyphFactory

Parameters:: glyphType - A com.esri.arcgis.display.esriDynamicGlyphType constant (in); fileName - The fileName (in); transparencyColor - A reference to a com.esri.arcgis.display.IColor (in)
Returns:: A reference to a com.esri.arcgis.display.IDynamicGlyph
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

loadDynamicGlyphsGroup

public int loadDynamicGlyphsGroup(String fileName)
                           throws IOException,
                                  AutomationException

Loads a dynamic glyph group from files.

Remarks

The fileName points to an XML file. This XML file holds information regarding the image files that should be used in order to load the group image, and a database that describes the identity, location, and size of the glyphs in the group.

On success, the method returns the ID of the loaded group. This ID can be used to get a dynamic glyph from the group, using the get property IDynamicGlyphFactory.DynamicGlyph, or unload the glyphs group, using the method IDynamicGlyphFactory.UnloadDynamicGlyphsGroup.

Product Availability

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

Specified by:: loadDynamicGlyphsGroup in interface IDynamicGlyphFactory

Parameters:: fileName - The fileName (in)
Returns:: The groupId
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

unloadDynamicGlyphsGroup

public void unloadDynamicGlyphsGroup(int groupId)
                              throws IOException,
                                     AutomationException

Unloads a dynamic glyph group, and any corresponding resources.

Remarks

When the Dynamic Glyphs Group is no longer needed, it is important to call this method in order to release the Group�s resources.

Unused Dynamic Glyph Groups that are not unloaded might result in memory leaks on the graphic card memory.

Product Availability

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

Specified by:: unloadDynamicGlyphsGroup in interface IDynamicGlyphFactory

Parameters:: groupId - The groupId (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getDynamicGlyph

public IDynamicGlyph getDynamicGlyph(int groupId,
                                     int glyphType,
                                     int index)
                              throws IOException,
                                     AutomationException

Retrieves a dynamic glyph from a glyph group.

Product Availability

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

Specified by:: getDynamicGlyph in interface IDynamicGlyphFactory

Parameters:: groupId - The groupId (in); glyphType - A com.esri.arcgis.display.esriDynamicGlyphType constant (in); index - The index (in)
Returns:: A reference to a com.esri.arcgis.display.IDynamicGlyph
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getCreatedDynamicGlyphSize

public void getCreatedDynamicGlyphSize(int glyphType,
                                       int[] sizeX,
                                       int[] sizeY)
                                throws IOException,
                                       AutomationException

Indicates the texture size of the created dynamic glyph.

Remarks

The Created Dynamic Glyph Size values determine the size of the texture that will be created when the CreateDynamicGlyph method will be used. These values need to be a power of two (2, 4, 8, 16, 32, 64, 128, 256, etc). If they are not a power of two, the values will be snapped to the lower power of two values. For example, a value of 33 will be adjusted to be 32.

Product Availability

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

Specified by:: getCreatedDynamicGlyphSize in interface IDynamicGlyphFactory2

Parameters:: glyphType - A com.esri.arcgis.display.esriDynamicGlyphType constant (in); sizeX - The sizeX (in/out: use single element array); sizeY - The sizeY (in/out: use single element array)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setCreatedDynamicGlyphSize

public void setCreatedDynamicGlyphSize(int glyphType,
                                       int sizeX,
                                       int sizeY)
                                throws IOException,
                                       AutomationException

Indicates the texture size of the created dynamic glyph.

Remarks

Product Availability

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

Specified by:: setCreatedDynamicGlyphSize in interface IDynamicGlyphFactory2

Parameters:: glyphType - A com.esri.arcgis.display.esriDynamicGlyphType constant (in); sizeX - The sizeX (in); sizeY - The sizeY (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

createDynamicGlyphFromBitmap

public IDynamicGlyph createDynamicGlyphFromBitmap(int glyphType,
                                                  int hBmp,
                                                  boolean preserveAlphaChannel,
                                                  IColor transparencyColor)
                                           throws IOException,
                                                  AutomationException

Create a dynamic glyph from a bitmap handle.

Remarks

Creates a dynamic glyph from a handle to a bitmap. If preserveAlphaChannel parameter is set, the method will honor the alpha values in the alpha channel, otherwise the alpha values will be set to to be opaque (255). If the transparency color parameter is not NULL, each pixel that matches the transparencyColor will be transparent (its alpha values in the glyph will be set to 0).

Product Availability

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

To get a handle to the bitmap (hBmp) you can use RasterPicture::loadPicture() or BasicRasterPicture::loadPicture(). These methods return an IPicture which has a getHandle() method that can be used to get the handle.

Specified by:: createDynamicGlyphFromBitmap in interface IDynamicGlyphFactory2

Parameters:: glyphType - A com.esri.arcgis.display.esriDynamicGlyphType constant (in); hBmp - The hBmp (A COM typedef) (in); preserveAlphaChannel - The preserveAlphaChannel (in); transparencyColor - A reference to a com.esri.arcgis.display.IColor (in)
Returns:: A reference to a com.esri.arcgis.display.IDynamicGlyph
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getDynamicGlyph

public IDynamicGlyph getDynamicGlyph(int dynamicSymbolType)
                              throws IOException,
                                     AutomationException

Indicates the dynamic glyph for the specified dynamic symbol.

Product Availability

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

Specified by:: getDynamicGlyph in interface IDynamicSymbolProperties

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in)
Returns:: A reference to a com.esri.arcgis.display.IDynamicGlyph
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setDynamicGlyphByRef

public void setDynamicGlyphByRef(int dynamicSymbolType,
                                 IDynamicGlyph dynamicGlyph)
                          throws IOException,
                                 AutomationException

Indicates the dynamic glyph for the specified dynamic symbol.

Remarks

Dynamic Glyph is a handle to a graphic resource that can be used in order to render the Dynamic Symbol.Use the Dynamic Glyph Factory in order to create and delete Dynamic Glyphs.

Product Availability

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

Specified by:: setDynamicGlyphByRef in interface IDynamicSymbolProperties

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in); dynamicGlyph - A reference to a com.esri.arcgis.display.IDynamicGlyph (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getScale

public void getScale(int dynamicSymbolType,
                     float[] scaleX,
                     float[] scaleY)
              throws IOException,
                     AutomationException

Scales the dynamic symbol.

Description

Gets the current relative scale for the specified dynamic symbol (text, marker, line, fill).

Remarks

The scale attribute can be used in order to reuse a glyph, and render it in different sizes, rather than creating a different glyph for each different size. This is recommended in order to minimize graphic resources usage.

Product Availability

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

Specified by:: getScale in interface IDynamicSymbolProperties

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in); scaleX - The scaleX (in/out: use single element array); scaleY - The scaleY (in/out: use single element array)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setScale

public void setScale(int dynamicSymbolType,
                     float scaleX,
                     float scaleY)
              throws IOException,
                     AutomationException

Scales the dynamic symbol.

Description

Sets the current relative scale for the specified dynamic symbol (text, marker, line, fill).

Remarks

Product Availability

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

Specified by:: setScale in interface IDynamicSymbolProperties

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in); scaleX - The scaleX (in); scaleY - The scaleY (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getColor

public void getColor(int dynamicSymbolType,
                     float[] red,
                     float[] green,
                     float[] blue,
                     float[] alpha)
              throws IOException,
                     AutomationException

Indicates the color for the specified dynamic symbol.

Remarks

The color attribute can be used in order to reuse a glyph, and render it in different colors, if possible, rather than creating a different glyph for each color. This is recommended in order to minimize graphic resources usage, and is possible with monochromatic symbols.

For monochromatic symbols (symbols that consist of only one color and might even have fixed black pixels), it is advisable to create a white-and-black dynamic glyph, and then set the DynamicSymbol’s color to the desired color. That will result in coloring the white pixels to the desired color, while leaving the black colors black. That method enables you to reuse a white-and-black glyph to draw different colors of the same glyph.

For multicolor symbols (symbols that contain more than just white and black colors in them), it is advisable to create the multicolor glyph, and then set the DynamicSymbol’s color to white. That will result in rendering the original colors of the glyph’s pixels.Use the alpha value in order to affect the Dynamic Symbol’s transparency level.

The target pixel color is being calculated by multiplying the Glyph’s color value with the value of the Color Property. For example - a white opaque color (R=1, G=1, B=1, A=1) will result in rendering the pixels with the original glyph’s color values, with the same transparency level.

Product Availability

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

Specified by:: getColor in interface IDynamicSymbolProperties

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in); red - The red (in/out: use single element array); green - The green (in/out: use single element array); blue - The blue (in/out: use single element array); alpha - The alpha (in/out: use single element array)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setColor

public void setColor(int dynamicSymbolType,
                     float red,
                     float green,
                     float blue,
                     float alpha)
              throws IOException,
                     AutomationException

Indicates the color for the specified dynamic symbol.

Remarks

Product Availability

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

Specified by:: setColor in interface IDynamicSymbolProperties

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in); red - The red (in); green - The green (in); blue - The blue (in); alpha - The alpha (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getRotationAlignment

public int getRotationAlignment(int dynamicSymbolType)
                         throws IOException,
                                AutomationException

Indicates the rotation alignment for the specified dynamic symbol.

Product Availability

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

Specified by:: getRotationAlignment in interface IDynamicSymbolProperties

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in)
Returns:: A com.esri.arcgis.display.esriDynamicSymbolRotationAlignment constant
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setRotationAlignment

public void setRotationAlignment(int dynamicSymbolType,
                                 int dynamicSymbolRotationAlignment)
                          throws IOException,
                                 AutomationException

Indicates the rotation alignment for the specified dynamic symbol.

Product Availability

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

Specified by:: setRotationAlignment in interface IDynamicSymbolProperties

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in); dynamicSymbolRotationAlignment - A com.esri.arcgis.display.esriDynamicSymbolRotationAlignment constant (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getHeading

public float getHeading(int dynamicSymbolType)
                 throws IOException,
                        AutomationException

Indicates the heading for the specified dynamic symbol, relative to the rotation alignment.

Product Availability

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

Specified by:: getHeading in interface IDynamicSymbolProperties

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in)
Returns:: The heading
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setHeading

public void setHeading(int dynamicSymbolType,
                       float heading)
                throws IOException,
                       AutomationException

Indicates the heading for the specified dynamic symbol, relative to the rotation alignment.

Product Availability

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

Specified by:: setHeading in interface IDynamicSymbolProperties

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in); heading - The heading (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

isSmooth

public boolean isSmooth(int dynamicSymbolType)
                 throws IOException,
                        AutomationException

Indicates whether the specified dynamic symbol will be smooth.

Product Availability

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

Specified by:: isSmooth in interface IDynamicSymbolProperties

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in)
Returns:: The smooth
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setSmooth

public void setSmooth(int dynamicSymbolType,
                      boolean smooth)
               throws IOException,
                      AutomationException

Indicates whether the specified dynamic symbol will be smooth.

Product Availability

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

Specified by:: setSmooth in interface IDynamicSymbolProperties

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in); smooth - The smooth (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getTextVerticalAlignment

public int getTextVerticalAlignment()
                             throws IOException,
                                    AutomationException

Indicates the vertical alignment for the dynamic text symbol.

Remarks

This property affects the anchor point of the text.

Product Availability

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

Specified by:: getTextVerticalAlignment in interface IDynamicSymbolProperties

Returns:: A com.esri.arcgis.display.esriTextVerticalAlignment constant
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setTextVerticalAlignment

public void setTextVerticalAlignment(int verticalAlignment)
                              throws IOException,
                                     AutomationException

Indicates the vertical alignment for the dynamic text symbol.

Remarks

This property affects the anchor point of the text.

Product Availability

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

Specified by:: setTextVerticalAlignment in interface IDynamicSymbolProperties

Parameters:: verticalAlignment - A com.esri.arcgis.display.esriTextVerticalAlignment constant (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getTextHorizontalAlignment

public int getTextHorizontalAlignment()
                               throws IOException,
                                      AutomationException

Indicates the horizontal alignment for the dynamic text symbol.

Remarks

This property affects the anchor point of the text.

Product Availability

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

Specified by:: getTextHorizontalAlignment in interface IDynamicSymbolProperties

Returns:: A com.esri.arcgis.display.esriTextHorizontalAlignment constant
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setTextHorizontalAlignment

public void setTextHorizontalAlignment(int horizontalAlignment)
                                throws IOException,
                                       AutomationException

Indicates the horizontal alignment for the dynamic text symbol.

Remarks

This property affects the anchor point of the text.

Product Availability

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

Specified by:: setTextHorizontalAlignment in interface IDynamicSymbolProperties

Parameters:: horizontalAlignment - A com.esri.arcgis.display.esriTextHorizontalAlignment constant (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getOffset

public void getOffset(int dynamicSymbolType,
                      float[] offsetX,
                      float[] offsetY)
               throws IOException,
                      AutomationException

Offsets the dynamic symbol.

Product Availability

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

Specified by:: getOffset in interface IDynamicSymbolProperties2

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in); offsetX - The offsetX (in/out: use single element array); offsetY - The offsetY (in/out: use single element array)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setOffset

public void setOffset(int dynamicSymbolType,
                      float offsetX,
                      float offsetY)
               throws IOException,
                      AutomationException

Offsets the dynamic symbol.

Product Availability

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

Specified by:: setOffset in interface IDynamicSymbolProperties2

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in); offsetX - The offsetX (in); offsetY - The offsetY (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

isUseReferenceScale

public boolean isUseReferenceScale(int dynamicSymbolType)
                            throws IOException,
                                   AutomationException

Indicates whether the specified dynamic symbol will conform to map reference scale.

Product Availability

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

Specified by:: isUseReferenceScale in interface IDynamicSymbolProperties2

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in)
Returns:: The useReferenceScale
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setUseReferenceScale

public void setUseReferenceScale(int dynamicSymbolType,
                                 boolean useReferenceScale)
                          throws IOException,
                                 AutomationException

Indicates whether the specified dynamic symbol will conform to map reference scale.

Product Availability

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

Specified by:: setUseReferenceScale in interface IDynamicSymbolProperties2

Parameters:: dynamicSymbolType - A com.esri.arcgis.display.esriDynamicSymbolType constant (in); useReferenceScale - The useReferenceScale (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getTextBoxMargins

public void getTextBoxMargins(float[] left,
                              float[] top,
                              float[] right,
                              float[] bottom)
                       throws IOException,
                              AutomationException

Indicates the text box margins for the dynamic text symbol.

Remarks

The Text Box Margins values, indicates a margin around the text in all four directions.

This also affects the anchor point of the text, along with the TextHorizontalAlignment and TextVerticalAlignment properties.

Product Availability

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

Specified by:: getTextBoxMargins in interface IDynamicSymbolProperties2

Parameters:: left - The left (in/out: use single element array); top - The top (in/out: use single element array); right - The right (in/out: use single element array); bottom - The bottom (in/out: use single element array)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setTextBoxMargins

public void setTextBoxMargins(float left,
                              float top,
                              float right,
                              float bottom)
                       throws IOException,
                              AutomationException

Indicates the text box margins for the dynamic text symbol.

Remarks

The Text Box Margins values, indicates a margin around the text in all four directions.

This also affects the anchor point of the text, along with the TextHorizontalAlignment and TextVerticalAlignment properties.

Product Availability

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

Specified by:: setTextBoxMargins in interface IDynamicSymbolProperties2

Parameters:: left - The left (in); top - The top (in); right - The right (in); bottom - The bottom (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getTextBoxHorizontalAlignment

public int getTextBoxHorizontalAlignment()
                                  throws IOException,
                                         AutomationException

Indicates the text box horizontal alignment for the dynamic text symbol.

Remarks

This property controls the Horizontal Alignment of the text inside the text box, while supporting multi lines text (using carriage return on each line end).

Product Availability

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

Specified by:: getTextBoxHorizontalAlignment in interface IDynamicSymbolProperties2

Returns:: A com.esri.arcgis.display.esriTextHorizontalAlignment constant
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setTextBoxHorizontalAlignment

public void setTextBoxHorizontalAlignment(int textBoxHorizontalAlignment)
                                   throws IOException,
                                          AutomationException

Indicates the text box horizontal alignment for the dynamic text symbol.

Remarks

This property controls the Horizontal Alignment of the text inside the text box, while supporting multi lines text (using carriage return on each line end).

Product Availability

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

Specified by:: setTextBoxHorizontalAlignment in interface IDynamicSymbolProperties2

Parameters:: textBoxHorizontalAlignment - A com.esri.arcgis.display.esriTextHorizontalAlignment constant (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

isTextBoxUseDynamicFillSymbol

public boolean isTextBoxUseDynamicFillSymbol()
                                      throws IOException,
                                             AutomationException

Indicates whether to use the dynamic fill symbol when drawing the text.

Remarks

When true, text will be rendered with a background Fill, using the current internal Dynamic Fill Symbol State.

When false, text will be rendered with no background Fill.

Product Availability

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

Specified by:: isTextBoxUseDynamicFillSymbol in interface IDynamicSymbolProperties2

Returns:: The use
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setTextBoxUseDynamicFillSymbol

public void setTextBoxUseDynamicFillSymbol(boolean use)
                                    throws IOException,
                                           AutomationException

Indicates whether to use the dynamic fill symbol when drawing the text.

Remarks

When true, text will be rendered with a background Fill, using the current internal Dynamic Fill Symbol State.

When false, text will be rendered with no background Fill.

Product Availability

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

Specified by:: setTextBoxUseDynamicFillSymbol in interface IDynamicSymbolProperties2

Parameters:: use - The use (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

isTextBoxUseDynamicLineSymbol

public boolean isTextBoxUseDynamicLineSymbol()
                                      throws IOException,
                                             AutomationException

Indicates whether to use the dynamic line symbol when drawing the text.

Remarks

When true, text will be rendered with an outline around the text box, using the current internal Dynamic Line Symbol State.

When false, text will be rendered with no outline around the text box.

Product Availability

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

Specified by:: isTextBoxUseDynamicLineSymbol in interface IDynamicSymbolProperties2

Returns:: The use
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setTextBoxUseDynamicLineSymbol

public void setTextBoxUseDynamicLineSymbol(boolean use)
                                    throws IOException,
                                           AutomationException

Indicates whether to use the dynamic line symbol when drawing the text.

Remarks

When true, text will be rendered with an outline around the text box, using the current internal Dynamic Line Symbol State.

When false, text will be rendered with no outline around the text box.

Product Availability

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

Specified by:: setTextBoxUseDynamicLineSymbol in interface IDynamicSymbolProperties2

Parameters:: use - The use (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getTextLeading

public float getTextLeading()
                     throws IOException,
                            AutomationException

Indicates the text leading for the dynamic text symbol.

Remarks

Text Leading specifies the spacing in pixels, between the multiple lines of a text box, when drawing text.

Product Availability

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

Specified by:: getTextLeading in interface IDynamicSymbolProperties2

Returns:: The leading
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setTextLeading

public void setTextLeading(float leading)
                    throws IOException,
                           AutomationException

Indicates the text leading for the dynamic text symbol.

Remarks

Text Leading specifies the spacing in pixels, between the multiple lines of a text box, when drawing text.

Product Availability

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

Specified by:: setTextLeading in interface IDynamicSymbolProperties2

Parameters:: leading - The leading (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getTextCharacterSpacing

public float getTextCharacterSpacing()
                              throws IOException,
                                     AutomationException

Indicates an additional space that is added to each character beyond what is defined by its character box in the TextGlyph.

Product Availability

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

Specified by:: getTextCharacterSpacing in interface IDynamicSymbolProperties2

Returns:: The characterSpacing
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setTextCharacterSpacing

public void setTextCharacterSpacing(float characterSpacing)
                             throws IOException,
                                    AutomationException

Indicates an additional space that is added to each character beyond what is defined by its character box in the TextGlyph.

Product Availability

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

Specified by:: setTextCharacterSpacing in interface IDynamicSymbolProperties2

Parameters:: characterSpacing - The characterSpacing (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getTextWordSpacing

public float getTextWordSpacing()
                         throws IOException,
                                AutomationException

Indicates an additional space that is added between words of the text string.

Product Availability

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

Specified by:: getTextWordSpacing in interface IDynamicSymbolProperties2

Returns:: The wordSpacing
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setTextWordSpacing

public void setTextWordSpacing(float wordSpacing)
                        throws IOException,
                               AutomationException

Indicates an additional space that is added between words of the text string.

Product Availability

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

Specified by:: setTextWordSpacing in interface IDynamicSymbolProperties2

Parameters:: wordSpacing - The wordSpacing (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

isTextRightToLeft

public boolean isTextRightToLeft()
                          throws IOException,
                                 AutomationException

Indicates whether the text is drawn from right to left for the dynamic text symbol.

Remarks

RightToLeft defines whether the text is to be displayed in a right to left manner. The default value is false, meaning Left To Right manner.

Product Availability

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

Specified by:: isTextRightToLeft in interface IDynamicSymbolProperties2

Returns:: The rightToLeft
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setTextRightToLeft

public void setTextRightToLeft(boolean rightToLeft)
                        throws IOException,
                               AutomationException

Indicates whether the text is drawn from right to left for the dynamic text symbol.

Remarks

RightToLeft defines whether the text is to be displayed in a right to left manner. The default value is false, meaning Left To Right manner.

Product Availability

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

Specified by:: setTextRightToLeft in interface IDynamicSymbolProperties2

Parameters:: rightToLeft - The rightToLeft (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getTextSize

public void getTextSize(String text,
                        float[] sizeX,
                        float[] sizeY)
                 throws IOException,
                        AutomationException

The text size in pixel screen coordinates.

Remarks

Returns the size of a given text, according to the current state of the internal Dynamic Symbols.

Product Availability

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

Specified by:: getTextSize in interface IDynamicSymbolProperties2

Parameters:: text - The text (in); sizeX - The sizeX (in/out: use single element array); sizeY - The sizeY (in/out: use single element array)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setLineContinuePattern

public void setLineContinuePattern(boolean continuePattern)
                            throws IOException,
                                   AutomationException

Indicates whether the line pattern is continued or restarted, for multi parts lines drawing.

Remarks

Taking drawing a polyline as an example, if you need to render a continuous pattern, and can�t have the pattern restarted in each of the polyline�s vertices, you should set this property to true.

Product Availability

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

Specified by:: setLineContinuePattern in interface IDynamicSymbolProperties2

Parameters:: continuePattern - The continuePattern (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

isLineContinuePattern

public boolean isLineContinuePattern()
                              throws IOException,
                                     AutomationException

Indicates whether the line pattern is continued or restarted, for multi parts lines drawing.

Remarks

Taking drawing a polyline as an example, if you need to render a continuous pattern, and can�t have the pattern restarted in each of the polyline�s vertices, you should set this property to true.

Product Availability

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

Specified by:: isLineContinuePattern in interface IDynamicSymbolProperties2

Returns:: The continuePattern
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

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.

getMarkerToTextOffset2

public void getMarkerToTextOffset2(float[] markerToTop,
                                   float[] markerToBottom,
                                   float[] markerToLeft,
                                   float[] markerToRight)
                            throws IOException,
                                   AutomationException

Indicates the offset of the text from the marker on each direction.

Remarks

Offset is the distance between the marker and the text labels, in each of the four directions�top, bottom, left, right.

Each text label gets an offset according to its region: top, bottom, left, right. The center text labels remain without an offset.

Product Availability

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

Specified by:: getMarkerToTextOffset2 in interface IDynamicCompoundMarker2

Parameters:: markerToTop - The markerToTop (in/out: use single element array); markerToBottom - The markerToBottom (in/out: use single element array); markerToLeft - The markerToLeft (in/out: use single element array); markerToRight - The markerToRight (in/out: use single element array)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setMarkerToTextOffset2

public void setMarkerToTextOffset2(float markerToTop,
                                   float markerToBottom,
                                   float markerToLeft,
                                   float markerToRight)
                            throws IOException,
                                   AutomationException

Indicates the offset of the text from the marker on each direction.

Remarks

Offset is the distance between the marker and the text labels, in each of the four directions � top, bottom, left, right.
Each text label gets an offset according to its region: top, bottom, left, right. The center text labels remain without an offset.

Product Availability

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

Specified by:: setMarkerToTextOffset2 in interface IDynamicCompoundMarker2

Parameters:: markerToTop - The markerToTop (in); markerToBottom - The markerToBottom (in); markerToLeft - The markerToLeft (in); markerToRight - The markerToRight (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

getTextSpacing

public void getTextSpacing(float[] textSpacingX,
                           float[] textSpacingY)
                    throws IOException,
                           AutomationException

Indicates the spacing between each two adjacent text boxes.

Remarks

Text spacing is the spacing between the text labels in each region (center, top, bottom, left, right). Y is the vertical spacing between each two adjacent text labels in a column. X is the horizontal spacing between each two columns of the same region.

Product Availability

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

Specified by:: getTextSpacing in interface IDynamicCompoundMarker2

Parameters:: textSpacingX - The textSpacingX (in/out: use single element array); textSpacingY - The textSpacingY (in/out: use single element array)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setTextSpacing

public void setTextSpacing(float textSpacingX,
                           float textSpacingY)
                    throws IOException,
                           AutomationException

Indicates the spacing between each two adjacent text boxes.

Remarks

Product Availability

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

Specified by:: setTextSpacing in interface IDynamicCompoundMarker2

Parameters:: textSpacingX - The textSpacingX (in); textSpacingY - The textSpacingY (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

isTextAutoAdjust

public boolean isTextAutoAdjust()
                         throws IOException,
                                AutomationException

Indicates whether the text boxes are to be auto ajdusted.

Remarks

When TextAutoAdjust is set to true, the text labels along with their text boxes, are realigned so that they will not overlap.

Product Availability

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

Specified by:: isTextAutoAdjust in interface IDynamicCompoundMarker2

Returns:: The autoAdjust
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

setTextAutoAdjust

public void setTextAutoAdjust(boolean autoAdjust)
                       throws IOException,
                              AutomationException

Indicates whether the text boxes are to be auto ajdusted.

Remarks

When TextAutoAdjust is set to true, the text labels along with their text boxes, are realigned so that they will not overlap.

Product Availability

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

Specified by:: setTextAutoAdjust in interface IDynamicCompoundMarker2

Parameters:: autoAdjust - The autoAdjust (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawArrayMarker

public void drawArrayMarker(IPoint point,
                            String[] textCenter,
                            String[] textLeft,
                            String[] textRight,
                            String[] textTop,
                            String[] textBottom)
                     throws IOException,
                            AutomationException

Draws a marker in a specific point on the map with text matricies around it.

Remarks

Draws an array of text labels column on each of the five marker�s regions: center, left, right, top, bottom. The location of the marker is given in map coordinates.

Product Availability

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

Specified by:: drawArrayMarker in interface IDynamicCompoundMarker2

Parameters:: point - A reference to a com.esri.arcgis.geometry.IPoint (in); textCenter - The textCenter (in); textLeft - The textLeft (in); textRight - The textRight (in); textTop - The textTop (in); textBottom - The textBottom (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

drawScreenArrayMarker

public void drawScreenArrayMarker(IPoint point,
                                  String[] textCenter,
                                  String[] textLeft,
                                  String[] textRight,
                                  String[] textTop,
                                  String[] textBottom)
                           throws IOException,
                                  AutomationException

Draws a marker in a specific point on the screen with text matricies around it.

Remarks

Draw an array of text labels column on each of the five marker�s regions: center, left, right, top, bottom. The location of the marker is given in screen (pixel) coordinates. 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 up.

Product Availability

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

Specified by:: drawScreenArrayMarker in interface IDynamicCompoundMarker2

Parameters:: point - A reference to a com.esri.arcgis.geometry.IPoint (in); textCenter - The textCenter (in); textLeft - The textLeft (in); textRight - The textRight (in); textTop - The textTop (in); textBottom - The textBottom (in)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

enumConnectionPoints

public void enumConnectionPoints(IEnumConnectionPoints[] ppEnum)
                          throws IOException,
                                 AutomationException

enumConnectionPoints

Description

IConnectionPointContainer is a Microsoft interface. Please refer to MSDN for information about this interface.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: enumConnectionPoints in interface IConnectionPointContainer

Parameters:: ppEnum - A reference to a com.esri.arcgis.display.IEnumConnectionPoints (out: use single element array)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

findConnectionPoint

public void findConnectionPoint(GUID riid,
                                IConnectionPoint[] ppCP)
                         throws IOException,
                                AutomationException

findConnectionPoint

Description

IConnectionPointContainer is a Microsoft interface. Please refer to MSDN for information about this interface.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: findConnectionPoint in interface IConnectionPointContainer

Parameters:: riid - A Structure: com.esri.arcgis.support.ms.stdole.GUID (in); ppCP - A reference to a com.esri.arcgis.display.IConnectionPoint (out: use single element array)
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

contentsChanged

public void contentsChanged(IActiveViewEventsContentsChangedEvent theEvent)
                     throws IOException,
                            AutomationException

Fired when the contents of the view changes.

Remarks

The Map object fires this event when a new document is loaded. Adding a new layer to a Map does not trigger this event.

The PageLayout object fires the event when IGraphicsContainer::DeleteAllElements in called and when a new document is loaded.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: contentsChanged in interface IActiveViewEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.
See Also:: IActiveView.contentsChanged()

contentsCleared

public void contentsCleared(IActiveViewEventsContentsClearedEvent theEvent)
                     throws IOException,
                            AutomationException

Fired when the contents of the view is cleared.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: contentsCleared in interface IActiveViewEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

itemAdded

public void itemAdded(IActiveViewEventsItemAddedEvent theEvent)
               throws IOException,
                      AutomationException

Fired when an item is added to the view.

Remarks

The Map fires the event every time a new layer is added.

The PageLayout fires this event whenever a new element is added to the layout. Elements include not only graphics but data frames as well.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: itemAdded in interface IActiveViewEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

itemDeleted

public void itemDeleted(IActiveViewEventsItemDeletedEvent theEvent)
                 throws IOException,
                        AutomationException

Fired when an item is deleted from the view.

Remarks

The PageLayout object fires this event whenever elements are deleted from the layout.

The Map object fires this event when a layer is removed.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: itemDeleted in interface IActiveViewEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

itemReordered

public void itemReordered(IActiveViewEventsItemReorderedEvent theEvent)
                   throws IOException,
                          AutomationException

Fired when a view item is reordered.

Remarks

The Map objects only fire this event whenever IMap::MoveLayer is called. In the ArcMap application, this occurs when you reorder layers in the table of contents. The Map will also fire this event when new layers are added.

The PageLayout object fires this event when changing the order of graphics. For example, IGraphicsContainer::BringToFront, PutElementOrder, SendToBack, SendBackward, and BringForward all fire this event. These functions are on ArcMap's Drawing menu under the Order pull right menu. Although the Map object is also a graphics container, it does not fire this event when its graphics are reordered.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: itemReordered in interface IActiveViewEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

selectionChanged

public void selectionChanged(IActiveViewEventsSelectionChangedEvent theEvent)
                      throws IOException,
                             AutomationException

Call this function to fire the selection changed event.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: selectionChanged in interface IActiveViewEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

viewRefreshed

public void viewRefreshed(IActiveViewEventsViewRefreshedEvent theEvent)
                   throws IOException,
                          AutomationException

Fired when view is refreshed before draw happens.

Description

Method that gets fired in response to IActiveView::Refresh and IActiveView::PartialRefresh.

Remarks

This event is useful in the case where you're watching for something to change in the view and there aren't any specific events for that change (e.g. ContentsChanged, ItemAdded). You can always listen for this method as a last resort. Care must be taken however to be very efficient in your implementation of this event because it will be called quite often.

The event parameters directly coincide with the arguments to IActiveView::PartialRefresh. For additional information about the arguments, see the help for that method.

If the event object connects to both the layout and a map, then the view parameter tells you which object initiated the event.

In an implementation of this method you typically want to check the phase and respond to only one. Otherwise, your code will execute multiple times per drawing sequence.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: viewRefreshed in interface IActiveViewEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

afterDraw

public void afterDraw(IActiveViewEventsAfterDrawEvent theEvent)
               throws IOException,
                      AutomationException

Fired after the specified phase is drawn.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: afterDraw in interface IActiveViewEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

afterItemDraw

public void afterItemDraw(IActiveViewEventsAfterItemDrawEvent theEvent)
                   throws IOException,
                          AutomationException

Fired after an individual view item is drawn. Example: view items include layers in a map or elements in a page layout.

Remarks

AfterItemDraw can be used to execute after each individual item has drawn. Event firing can be an expensive operation (time consuming) when there are many layers in a map, however. As a result, the AfterItemDraw event is only fired when the IViewManger::VerboseEvents property is set to True. By default this property is False.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: afterItemDraw in interface IActiveViewEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

focusMapChanged

public void focusMapChanged(IActiveViewEventsFocusMapChangedEvent theEvent)
                     throws IOException,
                            AutomationException

Fired when a new map is made active.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: focusMapChanged in interface IActiveViewEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

spatialReferenceChanged

public void spatialReferenceChanged(IActiveViewEventsSpatialReferenceChangedEvent theEvent)
                             throws IOException,
                                    AutomationException

Fired when the spatial reference is changed.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: spatialReferenceChanged in interface IActiveViewEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

boundsUpdated

public void boundsUpdated(ITransformEventsBoundsUpdatedEvent theEvent)
                   throws IOException,
                          AutomationException

Notifies clients when the bounds is updated.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: boundsUpdated in interface ITransformEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

visibleBoundsUpdated

public void visibleBoundsUpdated(ITransformEventsVisibleBoundsUpdatedEvent theEvent)
                          throws IOException,
                                 AutomationException

Notifies clients when the visible bounds is updated.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: visibleBoundsUpdated in interface ITransformEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

deviceFrameUpdated

public void deviceFrameUpdated(ITransformEventsDeviceFrameUpdatedEvent theEvent)
                        throws IOException,
                               AutomationException

Notifies clients when the device frame is updated.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: deviceFrameUpdated in interface ITransformEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

resolutionUpdated

public void resolutionUpdated(ITransformEventsResolutionUpdatedEvent theEvent)
                       throws IOException,
                              AutomationException

Notifies clients when the resolution is updated.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: resolutionUpdated in interface ITransformEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

rotationUpdated

public void rotationUpdated(ITransformEventsRotationUpdatedEvent theEvent)
                     throws IOException,
                            AutomationException

Notifies clients when the rotation angle is updated.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: rotationUpdated in interface ITransformEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

unitsUpdated

public void unitsUpdated(ITransformEventsUnitsUpdatedEvent theEvent)
                  throws IOException,
                         AutomationException

Notifies clients when the units are updated.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:: unitsUpdated in interface ITransformEvents

Parameters:: theEvent - The event
Throws:: IOException - If there are interop problems.; AutomationException - If the ArcObject component throws an exception.

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.esri.arcgis.carto Class DynamicDisplay

Product Availability

DynamicDisplay

equals

hashCode

getDynamicGlyphFactory

Remarks

Product Availability

drawMultipleMarkers

Remarks

Product Availability

drawMarker

Remarks

Product Availability

drawPolygon

Remarks

Product Availability

drawMultipleLines

Remarks

Product Availability

drawLine

Remarks

Product Availability

drawPolyline

Remarks

Product Availability

drawRectangle

Remarks

Product Availability

drawText

Remarks

Product Availability

isSupportStaticDrawing

Product Availability

setSupportStaticDrawing

Product Availability

locate

Product Availability

getSelectionIdentifier

Product Availability

insertDynamicDrawing

Product Availability

deleteDynamicDrawing

Product Availability

drawScreenMultipleMarkers

Remarks

Product Availability

drawScreenMarker

Remarks

Product Availability

drawScreenPolygon

Remarks

Product Availability

drawScreenMultipleLines

Remarks

Product Availability

drawScreenLine

Remarks

Product Availability

drawScreenPolyline

Remarks

Product Availability

drawScreenRectangle

Remarks

Product Availability

drawScreenText

Remarks

Product Availability

init

Remarks

Product Availability

createDynamicGlyph

Remarks

Product Availability

deleteDynamicGlyph

Remarks

Product Availability

createDynamicGlyphFromFile

Remarks

Product Availability

com.esri.arcgis.carto
Class DynamicDisplay