com.esri.arcgis.carto
Interface IMapExtent

All Superinterfaces:

Serializable

All Known Implementing Classes:

MapExtent

public interface IMapExtent
extends Serializable

Provides access to the Map Extent Map Area Interface.

Remarks

By default, the MapArea object is of type MapExtent. One way to change the map extent is using the object MapExtent to set a new geographic extent. This gives you the ability to set the extent of the map using an envelope. If the spatial reference of the map has changed, remember to adjust the spatial reference of the envelope accordingly.

If the aspect ratio of the input map is different from the aspect ratio of the requested image, the returned map extent will be adjusted to fit the image.

The creation of a new MapExtent object is only needed if the MapArea object has been changed.

When To Use

Use IMapExtent to apply a new geographic extent to a map by specifying a new envelope.

Product Availability

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

Method Summary

void	setExtent(IEnvelope rhs1) The geographic extent of the map.

Method Detail

setExtent

void setExtent(IEnvelope rhs1)
               throws IOException,
                      AutomationException

The geographic extent of the map.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

rhs1 - A reference to a com.esri.arcgis.geometry.IEnvelope (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.