ArcObjects Library Reference (Display)  

IDisplayTransformation.VisibleBounds Property

Visible extent in world coordinates.

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

Parameters

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.

Remarks

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

.NET Snippets

Convert Display Pixels to Map Units |

.NET Samples

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

.NET Related Topics

Building a map viewing application using the ArcGIS Engine controls |