com.esri.arcgis.display
Class IDynamicGlyphProxy

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

All Implemented Interfaces:

IDynamicGlyph, Externalizable, Serializable

public class IDynamicGlyphProxy
extends com.esri.arcgis.interop.Dispatch
implements IDynamicGlyph, Serializable

Provides access to handle to a resource that is used to render a dynamic symbol.

Remarks

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

In order to render a Dynamic Symbol using a Dynamic Glyph, use the IDynamicSymbolProperties.DynamicGlyph Property.

It is important to correctly manage the Dynamic Glyphs, in order to minimize the application memory usage. Incorrect management of Dynamic Glyphs will lead to over consumption of resources, and might result in poor performance and even application crash. Try to minimize the Dynamic Glyphs creation and reuse created Dynamic Glyphs as much as possible. For example, create a Dynamic Glyph from a white symbol, set the Dynamic Symbol’s glyph property to use the created Dynamic Glyph, and use the Dynamic Symbol’s color and scale properties, to render the Dynamic Symbol (that uses one created Dynamic Glyph) in different colors and sizes.

When a Dynamic Glyph is not in use anymore, use the IDynamicGlyphFactory.DeleteDynamicGlyph method to release the Dynamic Glyph’s resources.

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

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

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
void	getAnchor(float[] xAnchor, float[] yAnchor) Indicates the origin of the glyph from the the bottom left.
int	getGlyphType() Indicates the type of dynamic glyph.
void	queryDimensions(float[] width, float[] height) Returns the width and height, in pixels, of the glyph.
void	removeListener(String iidStr, Object theListener)
void	setAnchor(float xAnchor, float yAnchor) Indicates the origin of the glyph from the the bottom left.

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

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

Methods inherited from class java.lang.Object

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

Field Detail

noncastable

public boolean noncastable

Constructor Detail

IDynamicGlyphProxy

public IDynamicGlyphProxy()

IDynamicGlyphProxy

public IDynamicGlyphProxy(Object obj)
                   throws IOException

Throws:

IOException

IDynamicGlyphProxy

protected IDynamicGlyphProxy(Object obj,
                             String iid)
                      throws IOException

Throws:

IOException

Method Detail

addListener

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

Overrides:

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

Throws:

IOException

removeListener

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

Overrides:

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

Throws:

IOException

getGlyphType

public int getGlyphType()
                 throws IOException,
                        AutomationException

Indicates the type of dynamic glyph.

Remarks

Indicates whether the Dynamic Glyph is of type Marker, Text, Line, or Fill.

Product Availability

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

Specified by:

getGlyphType in interface IDynamicGlyph

Returns:

A com.esri.arcgis.display.esriDynamicGlyphType constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryDimensions

public void queryDimensions(float[] width,
                            float[] height)
                     throws IOException,
                            AutomationException

Returns the width and height, in pixels, of the glyph. The width of the text glyph will be the width of the space character.

Remarks

Retrieves the Dynamic Glyph’s actual size in pixels.

For Dynamic Text Glyphs, the height is the height of the font, and the width is the width of the space character. Use IDynamicSymbolProperties2.GetTextSize method to get the actual pixel size of a specific string (with a specific Dynamic Text Symbol).

Product Availability

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

Specified by:

queryDimensions in interface IDynamicGlyph

Parameters:

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

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getAnchor

public void getAnchor(float[] xAnchor,
                      float[] yAnchor)
               throws IOException,
                      AutomationException

Indicates the origin of the glyph from the the bottom left.

Remarks

The anchor is an offset value, relative to the glyph’s lower left corner, that defines the anchor point (hot point) of the glyph. For example, for a glyph that represents an arrow, use the offset from the lower left glyph to the arrow’s base point as the anchor of the glyph.

The X values grow towards the right, and the Y values grow towards the top.

Product Availability

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

Specified by:

getAnchor in interface IDynamicGlyph

Parameters:

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

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setAnchor

public void setAnchor(float xAnchor,
                      float yAnchor)
               throws IOException,
                      AutomationException

Indicates the origin of the glyph from the the bottom left.

Remarks

The anchor is an offset value, relative to the glyph’s lower left corner, that defines the anchor point (hot point) of the glyph. For example, for a glyph that represents an arrow, use the offset from the lower left glyph to the arrow’s base point as the anchor of the glyph.

The X values grow towards the right, and the Y values grow towards the top.

Product Availability

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

Specified by:

setAnchor in interface IDynamicGlyph

Parameters:

xAnchor - The xAnchor (in)

yAnchor - The yAnchor (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.