com.esri.arcgis.carto
Interface IMapInset2

All Superinterfaces:

Serializable

All Known Implementing Classes:

MapInset

public interface IMapInset2
extends Serializable

Provides access to members that control the inset map surrounds.

Product Availability

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

Method Summary

void	calculateVisibleBounds() Calculates the visible bounds by applying the zoom or scale parameter to MapBounds (used when snapshot is false).
String	getDescription() Description reflecting the current settings of the MapInset.
void	getDeviceFrame(int[] left, int[] top, int[] right, int[] bottom) Pixel extent of the inset.
IEnvelope	getFullExtent() The maximum extent shown by the inset.
IEnvelope	getMapBounds() The relative position of the inset to the associated map (used when the inset is live).
double	getReferenceScale() Reference scale of the inset.
IEnvelope	getVisibleBounds() The map extent shown by the inset (used when the inset is not live).
double	getZoomPercent() Zoom amount as a percentage.
double	getZoomScale() The zoom amount as an absolute Scale (i.e., 1:20000).
boolean	isLive() Indicates if the inset shows a live view of the underlying map.
boolean	isUsingZoomScale() Indicates if ZoomScale or ZoomPercent is being used.
void	setDeviceFrame(int left, int top, int right, int bottom) Pixel extent of the inset.
void	setFullExtent(IEnvelope fullExtent) The maximum extent shown by the inset.
void	setIsLive(boolean isLive) Indicates if the inset shows a live view of the underlying map.
void	setMapBounds(IEnvelope bounds) The relative position of the inset to the associated map (used when the inset is live).
void	setReferenceScale(double refScale) Reference scale of the inset.
void	setVisibleBounds(IEnvelope visibleBounds) The map extent shown by the inset (used when the inset is not live).
void	setZoomPercent(double percent) Zoom amount as a percentage.
void	setZoomScale(double scale) The zoom amount as an absolute Scale (i.e., 1:20000).

Method Detail

getMapBounds

IEnvelope getMapBounds()
                       throws IOException,
                              AutomationException

The relative position of the inset to the associated map (used when the inset is live). The zoom amount is applied to this rectangle to determine the visible bounds that is actually drawn.

Product Availability

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

Returns:

A reference to a com.esri.arcgis.geometry.IEnvelope

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setMapBounds

void setMapBounds(IEnvelope bounds)
                  throws IOException,
                         AutomationException

The relative position of the inset to the associated map (used when the inset is live). The zoom amount is applied to this rectangle to determine the visible bounds that is actually drawn.

Product Availability

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

Parameters:

bounds - 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.

getVisibleBounds

IEnvelope getVisibleBounds()
                           throws IOException,
                                  AutomationException

The map extent shown by the inset (used when the inset is not live).

Product Availability

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

Returns:

A reference to a com.esri.arcgis.geometry.IEnvelope

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setVisibleBounds

void setVisibleBounds(IEnvelope visibleBounds)
                      throws IOException,
                             AutomationException

The map extent shown by the inset (used when the inset is not live).

Product Availability

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

Parameters:

visibleBounds - 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.

isLive

boolean isLive()
               throws IOException,
                      AutomationException

Indicates if the inset shows a live view of the underlying map. False means a snapshot of the underlying map is taken at the time the flag is changed.

Product Availability

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

Returns:

The isLive

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setIsLive

void setIsLive(boolean isLive)
               throws IOException,
                      AutomationException

Indicates if the inset shows a live view of the underlying map. False means a snapshot of the underlying map is taken at the time the flag is changed.

Product Availability

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

Parameters:

isLive - The isLive (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isUsingZoomScale

boolean isUsingZoomScale()
                         throws IOException,
                                AutomationException

Indicates if ZoomScale or ZoomPercent is being used. The one specified last is being used.

Product Availability

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

Returns:

The usingZoomScale

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getZoomPercent

double getZoomPercent()
                      throws IOException,
                             AutomationException

Zoom amount as a percentage. 100 means show the underlying map at normal size.

Product Availability

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

Returns:

The percent

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setZoomPercent

void setZoomPercent(double percent)
                    throws IOException,
                           AutomationException

Zoom amount as a percentage. 100 means show the underlying map at normal size.

Product Availability

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

Parameters:

percent - The percent (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getZoomScale

double getZoomScale()
                    throws IOException,
                           AutomationException

The zoom amount as an absolute Scale (i.e., 1:20000).

Product Availability

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

Returns:

The scale

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setZoomScale

void setZoomScale(double scale)
                  throws IOException,
                         AutomationException

The zoom amount as an absolute Scale (i.e., 1:20000).

Product Availability

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

Parameters:

scale - The scale (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDescription

String getDescription()
                      throws IOException,
                             AutomationException

Description reflecting the current settings of the MapInset.

Product Availability

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

Returns:

The title

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

calculateVisibleBounds

void calculateVisibleBounds()
                            throws IOException,
                                   AutomationException

Calculates the visible bounds by applying the zoom or scale parameter to MapBounds (used when snapshot is false).

Product Availability

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getFullExtent

IEnvelope getFullExtent()
                        throws IOException,
                               AutomationException

The maximum extent shown by the inset.

Product Availability

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

Returns:

A reference to a com.esri.arcgis.geometry.IEnvelope

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setFullExtent

void setFullExtent(IEnvelope fullExtent)
                   throws IOException,
                          AutomationException

The maximum extent shown by the inset.

Product Availability

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

Parameters:

fullExtent - 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.

getReferenceScale

double getReferenceScale()
                         throws IOException,
                                AutomationException

Reference scale of the inset.

Product Availability

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

Returns:

The refScale

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setReferenceScale

void setReferenceScale(double refScale)
                       throws IOException,
                              AutomationException

Reference scale of the inset.

Product Availability

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

Parameters:

refScale - The refScale (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDeviceFrame

void getDeviceFrame(int[] left,
                    int[] top,
                    int[] right,
                    int[] bottom)
                    throws IOException,
                           AutomationException

Pixel extent of the inset.

Product Availability

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

Parameters:

left - The left (out: use single element array)

top - The top (out: use single element array)

right - The right (out: use single element array)

bottom - The bottom (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setDeviceFrame

void setDeviceFrame(int left,
                    int top,
                    int right,
                    int bottom)
                    throws IOException,
                           AutomationException

Pixel extent of the inset.

Product Availability

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

Parameters:

left - The left (in)

top - The top (in)

right - The right (in)

bottom - The bottom (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.