ArcObjects Library Reference (Display)  

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 [out, retval]

  Bounds is a parameter of type IEnvelope

Bounds [in]

  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.VisibleBounds Property | IDisplayTransformation.FittedBounds Property | ITin.Extent Property | IFeatureClassManage.UpdateExtent Method | IFeatureClassManage Interface

.NET Snippets

Convert Display Pixels to Map Units

.NET Samples

Dynamic display—tracking dynamic object (Code Files: TrackObject) | Copy the PageLayoutControl focus map and overwrite the MapControl map (Code Files: CopyFocusMap) | Building a MapViewer application using the ArcGIS Engine controls (Code Files: MapViewer)

.NET Related Topics

Building a map viewing application using the ArcGIS Engine controls