com.esri.arcgis.display
Class IDynamicSymbolProperties2Proxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.display.IDynamicSymbolPropertiesProxy
          com.esri.arcgis.display.IDynamicSymbolProperties2Proxy

All Implemented Interfaces:

IDynamicSymbolProperties, IDynamicSymbolProperties2, Externalizable, Serializable

public class IDynamicSymbolProperties2Proxy
extends IDynamicSymbolPropertiesProxy
implements IDynamicSymbolProperties2, Serializable

Provides access to dynamic symbol properties.

Description

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

Remarks

The Dynamic Display has four internal Dynamic Symbols that are being used to determine how the Dynamic Items are to be rendered. These internal Dynamic Symbols are:

· Dynamic Marker Symbol

· Dynamic Line Symbol

· Dynamic Fill Symbol

· Dynamic Text Symbol

The IDynamicSymbolProperties2 interface is used in order to set these four Dynamic Symbols’ Properties.

Each Dynamic Item that is rendered will be affected by the current state of the Internal Dynamic Symbols. For example, when DrawPolygon method is being called, the polygon’s fill will be rendered according to the current state of the internal Dynamic Fill Symbol, and the Polygon’s outline will be rendered according to the current state of the internal Dynamic Line Symbol.

Product Availability

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

See Also:

Serialized Form

Field Summary

boolean

noncastable

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

DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, objRef

Constructor Summary

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

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
void	getOffset(int dynamicSymbolType, float[] offsetX, float[] offsetY) Offsets the dynamic symbol.
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.
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.
float	getTextWordSpacing() Indicates an additional space that is added between words of the text string.
boolean	isLineContinuePattern() Indicates whether the line pattern is continued or restarted, for multi parts lines drawing.
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	removeListener(String iidStr, Object theListener)
void	setLineContinuePattern(boolean continuePattern) Indicates whether the line pattern is continued or restarted, for multi parts lines drawing.
void	setOffset(int dynamicSymbolType, float offsetX, float offsetY) Offsets the dynamic symbol.
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	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	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.

Methods inherited from class com.esri.arcgis.display.IDynamicSymbolPropertiesProxy

getColor, getDynamicGlyph, getHeading, getRotationAlignment, getScale, getTextHorizontalAlignment, getTextVerticalAlignment, isSmooth, setColor, setDynamicGlyphByRef, setHeading, setRotationAlignment, setScale, setSmooth, setTextHorizontalAlignment, setTextVerticalAlignment

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

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.esri.arcgis.display.IDynamicSymbolProperties

getColor, getDynamicGlyph, getHeading, getRotationAlignment, getScale, getTextHorizontalAlignment, getTextVerticalAlignment, isSmooth, setColor, setDynamicGlyphByRef, setHeading, setRotationAlignment, setScale, setSmooth, setTextHorizontalAlignment, setTextVerticalAlignment

Field Detail

noncastable

public boolean noncastable

Constructor Detail

IDynamicSymbolProperties2Proxy

public IDynamicSymbolProperties2Proxy()

IDynamicSymbolProperties2Proxy

public IDynamicSymbolProperties2Proxy(Object obj)
                               throws IOException

Throws:

IOException

IDynamicSymbolProperties2Proxy

protected IDynamicSymbolProperties2Proxy(Object obj,
                                         String iid)
                                  throws IOException

Throws:

IOException

Method Detail

addListener

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

Overrides:

addListener in class IDynamicSymbolPropertiesProxy

Throws:

IOException

removeListener

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

Overrides:

removeListener in class IDynamicSymbolPropertiesProxy

Throws:

IOException

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.