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

IDisplayTransformation.VisibleBounds Property (ArcObjects .NET 10.7 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Display > ESRI.ArcGIS.Display > Interfaces > ID > IDisplayTransformation Interface > IDisplayTransformation.VisibleBounds Property
ArcGIS Developer Help

IDisplayTransformation.VisibleBounds Property

Visible extent in world coordinates.

[Visual Basic .NET]
Public Property VisibleBounds As IEnvelope
public IEnvelope VisibleBounds {get; set;}
HRESULT get_VisibleBounds(
  IEnvelope* Bounds
HRESULT put_VisibleBounds(
  IEnvelope** Bounds
Bounds [in]

Bounds is a parameter of type IEnvelope* Bounds [out, retval]
Bounds is a parameter of type IEnvelope**

Product Availability

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


VisibleBounds controls the visible extent of the display. By setting this property to different extents, you will get zoom in / zoom out effects. The VisibleBounds must fit within the current Bounds.

IActiveView::Extent really stores its value in this property.  In data view, the Extent (VisibleBounds) is modified whenever the spatial reference changes.  Also, the Extent is set the first time a layer is added to the Map.  In layout view, the Extent is initially set to the page size.  In both views, zooming in or out changes the Extent.  The Extent is persisted in map documents.

When the VisibleBounds is set, it is always adjusted to match the aspect ratio the DeviceFrame and this is stored as the FittedBounds.

Setting the Visible Bounds also fires the ITransformEvents::BoundsUpdated and ITransformEvents::VisibleBoundsUpdated events to notify any clients that the bounds have changed.

See Also

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

.NET Samples

Building a MapViewer application using the ArcGIS Engine controls Copy the PageLayoutControl focus map and overwrite the MapControl map