com.esri.arcgis.controls
Interface IHookHelperEvents

All Superinterfaces:
EventListener, Serializable
All Known Implementing Classes:
IHookHelperEventsAdapter, IHookHelperEventsProxy

public interface IHookHelperEvents
extends EventListener, Serializable

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

Product Availability

Available with ArcGIS Engine.


Method Summary
 void onHookUpdated(IHookHelperEventsOnHookUpdatedEvent theEvent)
          Fires when the hook object or one of its properties has been replaced or updated.
 

Method Detail

onHookUpdated

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:

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

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:

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

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:

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

Remarks

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

Product Availability

Available with ArcGIS Engine.

Parameters:
theEvent - The event
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.