This document is archived and information here might be outdated. Recommended version. |
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 [in]
Bounds is a parameter of type IEnvelope* Bounds [out, retval]
Bounds is a parameter of type IEnvelope**
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.
IDisplayTransformation Interface | IActiveView.Extent Property | IDisplayTransformation.FittedBounds Property | IDisplayTransformation.VisibleBounds Property | IFeatureClassManage Interface | IFeatureClassManage.UpdateExtent Method | ITin.Extent Property