com.esri.arcgis.editor
Class IAnnotationConstructorProxy

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

All Implemented Interfaces:

IAnnotationConstructor, Externalizable, Serializable

public class IAnnotationConstructorProxy
extends com.esri.arcgis.interop.Dispatch
implements IAnnotationConstructor, Serializable

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

Remarks

Annotation Constructors provide specialized behavior for creating new annotation features. All annotation constructors implement the IAnnotationConstructor interface and are registered in the ESRI Annotation 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

	IAnnotationConstructorProxy()
	IAnnotationConstructorProxy(Object obj)
protected	IAnnotationConstructorProxy(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	beforeStoreAnnotation(IAnnotationFeature annotationFeature, IGeometry sketchGeometry) Lets the constructor know the annotation is about to be stored.
IDisplayFeedback	createFeedback() The display feedback for the constructor.
String	getName() Name of the annotation constructor.
int	getSketchGeometryType() The type of geometry used for the edit sketch constructor.
boolean	isCanFinish(IGeometry sketchGeometry) Indicates if the annotation feature can be constructed given the number of points in the edit sketch.
void	onKeyDown(int keyState, int shift) Called when a key is pressed.
void	onKeyUp(int keyState, int shift) Called when a key is pressed.
void	removeListener(String iidStr, Object theListener)
void	shutdown() The constructor start event.
void	startFeedback(IPoint point) Starts the display feedback for the annotation constructor.
void	startup(IEditor pEditor) The annotation editor extension.
void	stopFeedback() Stops the display feedback.
void	updateFeedback() Updates the display feedback with the current settings.

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

IAnnotationConstructorProxy

public IAnnotationConstructorProxy()

IAnnotationConstructorProxy

public IAnnotationConstructorProxy(Object obj)
                            throws IOException

Throws:

IOException

IAnnotationConstructorProxy

protected IAnnotationConstructorProxy(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 annotation constructor.

Remarks

Returns the name of the annotation constructor. This is the name listed in the Annotation Constructors control on the Annotation toolbar.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

getName in interface IAnnotationConstructor

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 annotation constructor.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

getSketchGeometryType in interface IAnnotationConstructor

Returns:

A com.esri.arcgis.geometry.esriGeometryType 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 annotation feature can be constructed given the number of points in the edit sketch.

Product Availability

Available with ArcGIS Desktop.

Specified by:

isCanFinish in interface IAnnotationConstructor

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.

startup

public void startup(IEditor pEditor)
             throws IOException,
                    AutomationException

The annotation editor extension.

Remarks

Startup is called when the constructor is instantiated by the AnnotationEditExtension. If you are implementing this interface Startup is where you should obtain a reference to IAnnotationEditExtension from the Editor.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

startup in interface IAnnotationConstructor

Parameters:

pEditor - A reference to a com.esri.arcgis.editor.IEditor (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 AnnotationEditExtension's destructor is called, typically when ArcMap is shut down.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

shutdown in interface IAnnotationConstructor

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 IAnnotationConstructor CreateFeedback is where the chosen feedback object should be instantiated. This includes both standard feedback objects like MoveFeedback, NewFeedback, RotateFeedback, or custom feedback objects.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

createFeedback in interface IAnnotationConstructor

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)
                   throws IOException,
                          AutomationException

Starts the display feedback for the annotation 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 IAnnotationConstructor

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.

addFeedbackPoint

public void addFeedbackPoint(IPoint point)
                      throws IOException,
                             AutomationException

Adds a point to the display feedback.

Remarks

AddFeedbackPoint is called whenever a point is added to the edit sketch. 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 IAnnotationConstructor

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.

updateFeedback

public void updateFeedback()
                    throws IOException,
                           AutomationException

Updates the display feedback with the current settings.

Remarks

Use UpdateFeedback when you change the characteristics of the feedback. An example of when you might use this method is when a new point is added to the sketch and the new point sets the angle at which the feedback is displayed.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

updateFeedback in interface IAnnotationConstructor

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 IAnnotationConstructor::CanFinish returns True.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

stopFeedback in interface IAnnotationConstructor

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onKeyDown

public void onKeyDown(int keyState,
                      int shift)
               throws IOException,
                      AutomationException

Called when a key is pressed.

Remarks

OnKeyDown may be used to listen for one or more keys being depressed and expose additional functionality. All annotation constructors have a set of keys that they respond to. See the list of hotkeys in the online help. Each constructor implements the 'W' key functionality to derive the text from the first feature under the cursor; this functionality is available to new annotation constructors.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

onKeyDown in interface IAnnotationConstructor

Parameters:

keyState - The keyState (in)

shift - The shift (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onKeyUp

public void onKeyUp(int keyState,
                    int shift)
             throws IOException,
                    AutomationException

Called when a key is pressed.

Remarks

OnKeyUp may be used to listen for one or more keys being released.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

onKeyUp in interface IAnnotationConstructor

Parameters:

keyState - The keyState (in)

shift - The shift (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

beforeStoreAnnotation

public void beforeStoreAnnotation(IAnnotationFeature annotationFeature,
                                  IGeometry sketchGeometry)
                           throws IOException,
                                  AutomationException

Lets the constructor know the annotation is about to be stored.

Remarks

Use BeforeStoreAnnotation to apply changes to the annotation feature being created before it is stored in the Geodatabase. At this time the location of the feature should be updated from its initial position if required. BeforeStoreAnnotation is called automatically when IAnnotationConstructor::CanFinish returns True.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Specified by:

beforeStoreAnnotation in interface IAnnotationConstructor

Parameters:

annotationFeature - A reference to a com.esri.arcgis.carto.IAnnotationFeature (in)

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.