com.esri.arcgis.controls
Class IHookHelperEventsProxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.controls.IHookHelperEventsProxy

All Implemented Interfaces:

IHookHelperEvents, Externalizable, Serializable, EventListener

public class IHookHelperEventsProxy
extends com.esri.arcgis.interop.Dispatch
implements IHookHelperEvents, Serializable

Provides access to events that occur when the state of a hook changes.

Product Availability

Available with ArcGIS Engine.

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

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

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
void	onHookUpdated(IHookHelperEventsOnHookUpdatedEvent theEvent) Fires when the hook object or one of its properties has been replaced or updated.
void	removeListener(String iidStr, Object theListener)

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

IHookHelperEventsProxy

public IHookHelperEventsProxy()

IHookHelperEventsProxy

public IHookHelperEventsProxy(Object obj)
                       throws IOException

Throws:

IOException

IHookHelperEventsProxy

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

onHookUpdated

public void onHookUpdated(IHookHelperEventsOnHookUpdatedEvent theEvent)
                   throws IOException,
                          AutomationException

Fires when the hook object or one of its properties has been replaced or updated.

Description

Fires when a change has been made to either a HookHelper, GlobeHookHelper or SceneHookHelper.

In a command implementation using the HookHelper, use the event to re-synch any member variables storing the IHookHelper::ActiveView, IHookHelper::FocusMap, IHookHelper::PageLayout or IHookHelper::OperationStack and to re-synch any event listeners (for example, if listening to IActiveViewEvents).

OnHookUpdated will fire in response to the following in an ArcGIS Engine application:

• IToolbarControlEvents::OnBuddyChanged
• IMapControlEvents2::OnMapReplaced
• IPageLayoutControlEvents::OnPageLayoutReplaced
• IPageLayoutControlEvents::OnFocusMapChanged

OnHookUpdated will fire in response to the following in the ArcMap application:

• IDocumentEventsDisp::ActiveViewChanged
• IDocumentEventsDisp::MapsChanged
• IDocumentEventsDisp::NewDocument
• IDocumentEventsDisp::OpenDocument
• IDocumentEventsDisp::CloseDocument
• Setting the IHookHelper::Hook property

In a command implmentation using the GlobeHookHelper, use the event to re-synch any member variables storing the IGlobeHookHelper::Hook, IGlobeHookHelper::ActiveViewer, IGlobeHookHelper::Camera, IGlobeHookHelper::Globe or IGlobeHookHelper::GlobeDisplay and to re-synch any event listeners (for example, if listening to IActiveViewEvents).

OnHookUpdated will fire in response to the following in an ArcGIS Engine application:

• IToolbarControlEvents::OnBuddyChanged
• IGlobeControlEvents::OnGlobeReplaced

OnHookUpdated will fire in response to the following in the ArcGlobe application:

• IGMxDocumentEventsDisp::NewDocument
• IGMxDocumentEventsDisp::OpenDocument
• IGMxDocumentEventsDisp::CloseDocument
• Setting the IGlobeHookHelper::Hook property

In a command implementation using the SceneHookHelper, use the event to re-synch any member variables storing the ISceneHookHelper::Hook, ISceneHookHelper::ActiveViewer, ISceneHookHelper::Camera, ISceneHookHelper::Scene, ISceneHookHelper::SceneGraph any event listeners (for example, if listening to IActiveViewEvents ).

OnHookUpdated will fire in response to the following in an ArcGIS Engine application:

• IToolbarControlEvents::OnBuddyChanged
• ISceneControlEvents::OnSceneReplaced

OnHookUpdated will fire in response to the following in the ArcScene application:

• ISxDocumentEventsDisp::NewDocument
• ISxDocumentEventsDisp::OpenDocument
• ISxDocumentEventsDisp::CloseDocument
• Setting the ISceneHookHelper::Hook property

Remarks

The following are recommended when using the HookHelper, GlobeHookHelper or SceneHookHelper in cutsom commands:

• Where possible avoid storing member variables to IHookHelper::ActiveView, IHookHelper::FocusMap, IHookHelper::PageLayout or IHookHelper::OperationStack. Instead store one member variable to the HookHelper object, and use the HookHelper to return the latest object.
• Where possible avoid storing member variables to IGlobeHookHelper::ActiveViewer, IGlobeHookHelper::Camera, IGlobeHookHelper::Globe or IGlobeHookHelper::GlobeDisplay . Instead store one member variable to the GlobeHookHelper object.
• Where possible avoid storing member variables to ISceneHookHelper::ActiveViewer, ISceneHookHelper::Camera, ISceneHookHelper::Scene, ISceneHookHelper::SceneGraph . Instead store one member variable to the SceneHookHelper object.
• Programmatically handle the abscene of an ActiveView, PageLayout, Map, Scene or Globe by setting the ICommand::Enabled property to false.

Product Availability

Available with ArcGIS Engine.

Specified by:

onHookUpdated in interface IHookHelperEvents

Parameters:

theEvent - The event

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.