This document is archived and information here might be outdated.  Recommended version.

IActiveViewEvents Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Carto > ESRI.ArcGIS.Carto > Interfaces > IA > IActiveViewEvents Interface
ArcGIS Developer Help

IActiveViewEvents Interface

Provides access to events that occur when the state of the active view changes.

Product Availability

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

When To Use

Use this interface to listen for specific events related to the active view, such as AfterDraw and SelectionChanged. Many CoClasses implement this interface and each fires events differently. For example, the Map object does not fire the FocusMapChanged event, whereas the PageLayout object does. Similarly, the Map object fires the ItemDeleted event when a layer is removed from the Map and the PageLayout fires the same event when elements such as a map frame or graphic are deleted.

Be aware of the specific object's events to which you are listening. For example, writing code to listen for the SelectionChanged event on just the FocusMap object will not fire an event by changing the selection in layout view. Also, if the focus map changes you must reset the client.

The AfterItemDraw event will only be fired when the IViewManager::VerboseEvents property is set to True. By default, this property is set to False.


Name Description
Method AfterDraw Fired after the specified phase is drawn.
Method AfterItemDraw Fired after an individual view item is drawn. Example: view items include layers in a map or elements in a page layout.
Method ContentsChanged Fired when the contents of the view changes.
Method ContentsCleared Fired when the contents of the view is cleared.
Method FocusMapChanged Fired when a new map is made active.
Method ItemAdded Fired when an item is added to the view.
Method ItemDeleted Fired when an item is deleted from the view.
Method ItemReordered Fired when a view item is reordered.
Method SelectionChanged Call this function to fire the selection changed event.
Method SpatialReferenceChanged Fired when the spatial reference is changed.
Method ViewRefreshed Fired when view is refreshed before draw happens.

Classes that implement IActiveViewEvents

Classes Description
ActiveViewEventsListener (esriSystemUtility) Helper coclass to provide event IActiveViewEvents support to the C++ API.
Adjustment (esriEditorExt) The Adjustment Tools Editor Extension.
AnimationExtension (esriAnimation) The Animation Extension Object.
BAImageInsetWindow (esriArcMapUI) Window to display BAImageInsets.
CadastralEditorExtension (esriCadastralUI) Cadastral Editor Extension Object.
ColorCorrectionDockWin (esriArcMapUI) The Color Correction Tools Dockable Window.
ControlsMapZoomToolControl (esriControls) Zooms the map by a particular percentage.
ControlsPageZoomToolControl (esriControls) Zooms the map layout by a particular percentage.
CreateFeatureDockWin (esriEditor) Esri create features window.
DataClockChart (esriTrackingAnalystUI) Controls settings for the data clock chart.
DataGraphTElement (esriCartoUI) A container for the display and manipulation of data graph graphic element on the ArcMap layout view.
DataGraphWindow (esriArcMapUI) Window in hosting and displaying data graph.
DynamicDisplay Dynamic display class, used by the dynamic map.
Editor (esriEditor) The Object Editor Extension.
EngineInkEnvironment (esriControls) A singleton object representing Engine ink environment.
FindWindowUI (esriArcMapUI) Window to display Find dialog in. Deprecated. Please consider using the IFind interface in the Carto library instead.
FMEAnnotation (esriDataInteropUI) FMEAnnotation Class
Globe (esriGlobeCore) A container for the display and manipulation of data in the Globe.
GlobeDisplay (esriGlobeCore) The globe display object.
GlobeGraphicsLayer (esriGlobeCore) The Globe Graphics Layer.
GraphicsLayer3D (esri3DAnalyst) A 3D Graphics Layer.
GraphicTracker (esriEngineCore) A collection of Graphics that will be displayed on a Map or Globe
HistoryViewerWindow (esriArcMapUI) History Viewer Window
ImageInsetWindow (esriArcMapUI) Window to display ImageInsets.
LabelCache Standard labeling label cache.
LabelEngine (esriTrackingAnalyst) Controls functionality of the label engine.
Legend A map surround for displaying a legend.
Map A container for the display and manipulation of map data.
MapFrame A graphic element for displaying maps.
MapInsetWindow (esriArcMapUI) Window to display MapInsets.
MetadataViewWindow (esriArcMapUI) MetadataViewWindow class used to display the metadata of selected layer's data source.
NAWindow (esriNetworkAnalystUI) The network analysis window.
NetworkAnalystExtension (esriNetworkAnalystUI) The extension for network analysis.
OverviewWindow (esriArcMapUI) Window to display Overviews.
PageLayout Page Layout class contains maps and map surrounds.
PixelInspectionDockWin (esriArcMapUI) The Pixel Inspection Dockable Window.
RasterToolsDockWin (esriArcMapUI) The Raster Tools Dockable Window.
RealTimeFeedManager The real-time feed manager object.
ReportSelection (esriArcMapUI) Captures selection change, and reports this on the status bar.
Scene (esri3DAnalyst) A container for the display and manipulation of data.
SceneGraph (esri3DAnalyst) A container for recording data and events that occur in a scene.
TableProperties (esriArcMapUI) Table window properties.
TADynamicDisplayRefreshController (esriTrackingAnalyst) Manages all dynamic updates to all of ArcMap's maps, both in the map view and the page layout view.
TOCCatalogView (esriArcMapUI) Esri TOC Catalog View.
TOCDisplayView (esriArcMapUI) Esri TOC Display View.
TOCGMxCatalogView (esriArcGlobe) Esri TOC GMx Catalog View.
TOCGMxDisplayView (esriArcGlobe) Esri TOC GMx Display View.
TOCGMxTypeView (esriArcGlobe) Esri TOC GMx Type View.
TOCSelectionView (esriArcMapUI) Esri TOC Selection View.
TOCSxCatalogView (esriArcScene) Esri TOC Sx Catalog View.
TOCSxDisplayView (esriArcScene) Esri TOC Sx Display View.
TopologyExtension (esriEditorExt) Extension for working with topology.
UnplacedAnnotationWindow (esriEditor) Esri unplaced anno window.