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

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

IActiveView.Extent Property

The visible extent rectangle.

[Visual Basic .NET]
Public Property Extent As IEnvelope
public IEnvelope Extent {get; set;}
HRESULT get_Extent(
  IEnvelope** Extent
HRESULT put_Extent(
  IEnvelope* Extent
Extent [out, retval]

Extent is a parameter of type IEnvelope** Extent [in]
Extent is a parameter of type IEnvelope*

Product Availability

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


The Extent property holds the visible area of the view.  The Extent is automatically captured whenever the view's transformation changes.  For example, when the active view is a Map, the Extent is modified whenever the spatial reference changes.  Also, the Extent is set the first time a layer is added to a Map.  In layout view, the Extent is initially set to the page size.  In both layout view and data view, zooming in our out changes the Extent. 

The Extent is always adjusted to fit the device frame and it is persisted in the map document.

See Also

IActiveView Interface | IActiveView.Extent Property | IDisplayTransformation.FittedBounds Property | IDisplayTransformation.VisibleBounds Property | IFeatureClassManage Interface | IFeatureClassManage.UpdateExtent Method | ITin.Extent Property

.NET Samples

Custom UI elements using add-ins Custom reshape polyline edit task Building a MapViewer application using the ArcGIS Engine controls Copy the PageLayoutControl focus map and overwrite the MapControl map RSS weather layer StreetMap routing