com.esri.arcgis.editor
Class IDimensionConstructorProxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.editor.IDimensionConstructorProxy

All Implemented Interfaces:

IDimensionConstructor, Externalizable, Serializable

public class IDimensionConstructorProxy
extends com.esri.arcgis.interop.Dispatch
implements IDimensionConstructor, Serializable

Provides access to members that control the dimension feature edit sketch constructor.

Remarks

Dimension Constructors provide specialized behavior for creating new dimension features. All dimension constructors implement the IDimensionConstructor interface and are registered in the ESRI Dimension Constructors component category.

Product Availability

Available with ArcGIS Desktop.

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

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

Method Summary

void	addFeedbackPoint(IPoint point) Adds a point to the display feedback.
void	addListener(String iidStr, Object theListener, Object theSource)
void	constructDimension(IDimensionFeature feature, IGeometry geometry, IDimensionStyle style) Creates the dimension shape for a dimension feature given the geometry constructed in the dimension constructor.
IDisplayFeedback	createFeedback() The display feedback for the constructor.
int	getDimensionType() The type of dimension created with the dimension constructor.
String	getName() Name of the dimension constructor.
int	getSketchGeometryType() The type of geometry used for the edit sketch constructor.
boolean	isCanFinish(IGeometry sketchGeometry) Indicates if the dimension feature can be constructed given the number of points in the edit sketch.
boolean	isHasFeedback() Indicates if the constructor will use a custom feedback.
void	removeListener(String iidStr, Object theListener)
void	shutdown() The constructor start event.
void	startFeedback(IPoint point, IDimensionStyle style) Starts the display feedback for the dimension constructor.
void	startFeedbackFromShape(IGeometry shape, IDimensionStyle style) Starts the display feedback for the dimension constructor from an existing geometry.
void	startup(IDimensionEditExtension extension) The dimension editor extension.
void	stopFeedback() Stops the display feedback.

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

IDimensionConstructorProxy

public IDimensionConstructorProxy()

IDimensionConstructorProxy

public IDimensionConstructorProxy(Object obj)
                           throws IOException

Throws:

IOException

IDimensionConstructorProxy

protected IDimensionConstructorProxy(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

getName

public String getName()
               throws IOException,
                      AutomationException

Name of the dimension constructor.

Remarks

Returns the name of the dimension constructor. This is the name listed in the Dimension Constructors control on the Dimensioning toolbar.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

getName in interface IDimensionConstructor

Returns:

The name

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSketchGeometryType

public int getSketchGeometryType()
                          throws IOException,
                                 AutomationException

The type of geometry used for the edit sketch constructor.

Remarks

Returns the geometry type of the dimension constructor used for the sketch geometry. Most of the standard dimension constructors use esriGeometryMultipoint.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

getSketchGeometryType in interface IDimensionConstructor

Returns:

A com.esri.arcgis.geometry.esriGeometryType constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDimensionType

public int getDimensionType()
                     throws IOException,
                            AutomationException

The type of dimension created with the dimension constructor.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

getDimensionType in interface IDimensionConstructor

Returns:

A com.esri.arcgis.carto.esriDimensionType constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isCanFinish

public boolean isCanFinish(IGeometry sketchGeometry)
                    throws IOException,
                           AutomationException

Indicates if the dimension feature can be constructed given the number of points in the edit sketch.

Product Availability

Available with ArcGIS Desktop.

Specified by:

isCanFinish in interface IDimensionConstructor

Parameters:

sketchGeometry - A reference to a com.esri.arcgis.geometry.IGeometry (in)

Returns:

The canFinish

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

constructDimension

public void constructDimension(IDimensionFeature feature,
                               IGeometry geometry,
                               IDimensionStyle style)
                        throws IOException,
                               AutomationException

Creates the dimension shape for a dimension feature given the geometry constructed in the dimension constructor.

Remarks

When IDimensionConstructor::CanFinish returns True ConstructDimension is called.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

constructDimension in interface IDimensionConstructor

Parameters:

feature - A reference to a com.esri.arcgis.carto.IDimensionFeature (in)

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

style - A reference to a com.esri.arcgis.carto.IDimensionStyle (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

startup

public void startup(IDimensionEditExtension extension)
             throws IOException,
                    AutomationException

The dimension editor extension.

Remarks

Startup is called when the constructor is instantiated by the DimensionEditExtension.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

startup in interface IDimensionConstructor

Parameters:

extension - A reference to a com.esri.arcgis.editor.IDimensionEditExtension (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

shutdown

public void shutdown()
              throws IOException,
                     AutomationException

The constructor start event.

Remarks

Shutdown is called when the DimensionEditExtension's destructor is called, typically when ArcMap is shut down.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

shutdown in interface IDimensionConstructor

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createFeedback

public IDisplayFeedback createFeedback()
                                throws IOException,
                                       AutomationException

The display feedback for the constructor.

Remarks

When implementing IDimensionConstructor CreateFeedback is where the chosen feedback object should be instantiated and the necessary properties of the feedback object are set. For example, you should set the DimensionType and ReferenceScale, and ReferenceUnits values on the feedback object at this time.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

createFeedback in interface IDimensionConstructor

Returns:

A reference to a com.esri.arcgis.display.IDisplayFeedback

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

startFeedback

public void startFeedback(IPoint point,
                          IDimensionStyle style)
                   throws IOException,
                          AutomationException

Starts the display feedback for the dimension constructor.

Remarks

StartFeedback will start the display of the feedback object when the first point is added to the edit sketch. All properties required by the feedback object should be specified at this point and the feedback should be started.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

startFeedback in interface IDimensionConstructor

Parameters:

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

style - A reference to a com.esri.arcgis.carto.IDimensionStyle (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addFeedbackPoint

public void addFeedbackPoint(IPoint point)
                      throws IOException,
                             AutomationException

Adds a point to the display feedback.

Remarks

When the first point is added StartFeedbackFromShape is called. For all subsequent points that are added AddFeedbackPoint is called. The point can be used to update the feedback if desired.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

addFeedbackPoint in interface IDimensionConstructor

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.

stopFeedback

public void stopFeedback()
                  throws IOException,
                         AutomationException

Stops the display feedback.

Remarks

StopFeedback will stop the display feedback. StopFeedback is automatically called when IDimensionConstructor::CanFinish returns True. At this time you should stop the DimensionFeedback object and dereference it. If desired you can use the IDimensionShape returned from INewDimensionFeedback::Stop as the basis for constructing the dimension feature. ConstructDimension is called immediately follwing StopFeedback.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

stopFeedback in interface IDimensionConstructor

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isHasFeedback

public boolean isHasFeedback()
                      throws IOException,
                             AutomationException

Indicates if the constructor will use a custom feedback.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

isHasFeedback in interface IDimensionConstructor

Returns:

The hasFeedback

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

startFeedbackFromShape

public void startFeedbackFromShape(IGeometry shape,
                                   IDimensionStyle style)
                            throws IOException,
                                   AutomationException

Starts the display feedback for the dimension constructor from an existing geometry.

Remarks

StartFeedbackFromShape is called when the first point is added to the edit sketch. The input geometry should be used to add all the points in the sketchGeometry to the DimensionFeedback object.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

startFeedbackFromShape in interface IDimensionConstructor

Parameters:

shape - A reference to a com.esri.arcgis.geometry.IGeometry (in)

style - A reference to a com.esri.arcgis.carto.IDimensionStyle (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.