com.esri.arcgis.controls
Class ARMap

java.lang.Object
  com.esri.arcgis.controls.ARMap

All Implemented Interfaces:

IARMap, com.esri.arcgis.interop.RemoteObjRef, java.io.Serializable

public class ARMap
extends java.lang.Object
implements com.esri.arcgis.interop.RemoteObjRef, IARMap

COM Class 'ARMap'. Generated 3/19/2015 1:20:50 PM from 'C:\ArcGIS\COM\esriPublisherControls.olb'

Description 'The ARMap container for the display of map data.' Generator Options: PromptForTypeLibraries = False ClashPrefix = esri_ LowerCaseMemberNames = True IDispatchOnly = False RetryOnReject = False AwtForOcxs = True ArraysAsObjects = False DontRenameSameMethods = False ImplementConflictingInterfaces = True ReuseMethods = True RenameConflictingInterfaceMethods = True GenBeanInfo = True GenerateJavadoc =

See Also:

Serialized Form

Field Summary

Fields inherited from interface com.esri.arcgis.controls.IARMap

DISPID_1_GET_NAME, DISPID_1_PUT_NAME, DISPID_10_NAME, DISPID_11_NAME, DISPID_12_NAME, DISPID_13_GET_NAME, DISPID_14_NAME, DISPID_15_NAME, DISPID_16_NAME, DISPID_17_NAME, DISPID_18_GET_NAME, DISPID_18_PUT_NAME, DISPID_19_NAME, DISPID_2_NAME, DISPID_20_NAME, DISPID_21_GET_NAME, DISPID_22_NAME, DISPID_23_GET_NAME, DISPID_24_NAME, DISPID_25_GET_NAME, DISPID_26_GET_NAME, DISPID_27_GET_NAME, DISPID_28_NAME, DISPID_29_NAME, DISPID_3_GET_NAME, DISPID_30_NAME, DISPID_31_GET_NAME, DISPID_31_PUT_NAME, DISPID_32_NAME, DISPID_4_GET_NAME, DISPID_5_GET_NAME, DISPID_6_GET_NAME, DISPID_7_GET_NAME, DISPID_8_GET_NAME, DISPID_9_GET_NAME, IID, IIDb27adbe0_9c31_48db_87a8_0434e88180c2, xxDummy

Constructor Summary

ARMap(java.lang.Object obj)
Construct a ARMap using a reference to such an object returned from ArcGIS Engine or Server.

Method Summary

void	centerAt(double xCoord, double yCoord) Moves the center of the map to the specified point.
void	centerAtBookmark(java.lang.Object vBookmarkID) Centers the map display on the bookmark.
boolean	equals(java.lang.Object o) Compare this object with another
IARLayer	getARLayer(int index) The layer at the specified index.
int	getARLayerCount() The number of layer in the map's layer collection.
int	getBookmarkCount() The number of bookmarks in the map's bookmark collection.
java.lang.String	getBookmarkName(int index) The name of the bookmark.
java.lang.Object	getCustomProperty() A property to associate data with an object.
java.lang.String	getDescription() The description of the map.
int	getDistanceUnits() The distance units of the map.
void	getExtent(double[] xMin, double[] yMin, double[] xMax, double[] yMax) The visible extent of the map.
void	getFullExtent(double[] xMin, double[] yMin, double[] xMax, double[] yMax) The extent of all the data within the map.
java.lang.Object	getInternalObject() The internal ArcObjects IMap object.
com.esri.arcgis.interop.Dispatch	getJintegraDispatch() Deprecated. Internal use only.
double	getMapScale() The scale of the map as a representative fraction.
int	getMapUnits() The geographical units of the map.
java.lang.String	getName() The name of the map.
double	getReferenceScale() The reference scale of the map as a representative fraction.
double	getRotation() The number of degrees the map display is rotated.
java.lang.String	getSpatialReferenceName() The name of the map's spatial reference.
int	hashCode() the hashcode for this object
boolean	isCanRedoExtent() Indicates if there is a map extent that can be redone.
boolean	isCanUndoExtent() Indicates if there is a map extent that can be undone.
void	pan(int direction, double screenPercentage) Pans the map by a factor in a specified direction.
IARFeatureSet	queryARFeatures(IARSearchDef pSearchDef) Searches the map using a search definition and returns an ARFeatureSet.
void	redoExtent() Redo the next map extent in the stack.
void	refresh(boolean refreshNow) Redraws the map display area.
void	release() Release a ARMap.
IARFeatureCursor	searchARFeatures(IARSearchDef pSearchDef) Searches the map using a search definition and returns an ARFeatureCursor.
void	setCustomProperty(java.lang.Object pVal) A property to associate data with an object.
void	setExtent(double xMin, double yMin, double xMax, double yMax) Sets the visible extent of the map.
void	setMapScale(double mapScale) The scale of the map as a representative fraction.
void	setRotation(double mapRotation) The number of degrees the map display is rotated.
void	toMapPoint(int x, int y, double[] xCoord, double[] yCoord) Converts a point in device coordinates (typically pixels) to coordinates in map units.
void	undoExtent() Undo to the previous map extent in the stack.
void	zoomIn(double factor) Zooms in on the map by a factor.
void	zoomOut(double factor) Zooms out on the map by a factor.
void	zoomToBookmark(java.lang.Object vBookmarkID) Zooms the map display to the bookmark.
void	zoomToFullExtent() Zoom to the full extent of all data within the map.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ARMap

public ARMap(java.lang.Object obj)
      throws java.io.IOException

Construct a ARMap using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to ARMap.
Casting to this class from the return value of a method will not work, as this class represents an abstract class in ArcObjects.
*
ARMap o = (ARMap)obj; // will not work

ARMap o = new ARMap(obj); // Use this constructor instead
* @param obj an object returned from ArcGIS Engine or Server

Throws:

java.io.IOException - if there are interop problems ARMap theARMap = (ARMap) obj;

Method Detail

equals

public boolean equals(java.lang.Object o)

Compare this object with another

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

the hashcode for this object

Overrides:

hashCode in class java.lang.Object

getJintegraDispatch

public com.esri.arcgis.interop.Dispatch getJintegraDispatch()

Deprecated. Internal use only.

Specified by:

getJintegraDispatch in interface com.esri.arcgis.interop.RemoteObjRef

release

public void release()

Release a ARMap.

Specified by:

release in interface com.esri.arcgis.interop.RemoteObjRef

setMapScale

public void setMapScale(double mapScale)
                 throws java.io.IOException,
                        AutomationException

The scale of the map as a representative fraction.

Specified by:

setMapScale in interface IARMap

Parameters:

mapScale - The mapScale (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMapScale

public double getMapScale()
                   throws java.io.IOException,
                          AutomationException

The scale of the map as a representative fraction.

Specified by:

getMapScale in interface IARMap

Returns:

The mapScale

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

refresh

public void refresh(boolean refreshNow)
             throws java.io.IOException,
                    AutomationException

Redraws the map display area.

Specified by:

refresh in interface IARMap

Parameters:

refreshNow - The refreshNow (in, optional, pass false if not required)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getName

public java.lang.String getName()
                         throws java.io.IOException,
                                AutomationException

The name of the map.

Specified by:

getName in interface IARMap

Returns:

The sName

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getARLayerCount

public int getARLayerCount()
                    throws java.io.IOException,
                           AutomationException

The number of layer in the map's layer collection.

Specified by:

getARLayerCount in interface IARMap

Returns:

The count

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getARLayer

public IARLayer getARLayer(int index)
                    throws java.io.IOException,
                           AutomationException

The layer at the specified index.

Specified by:

getARLayer in interface IARMap

Parameters:

index - The index (in)

Returns:

A reference to a com.esri.arcgis.controls.IARLayer

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDescription

public java.lang.String getDescription()
                                throws java.io.IOException,
                                       AutomationException

The description of the map.

Specified by:

getDescription in interface IARMap

Returns:

The sDesciption

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSpatialReferenceName

public java.lang.String getSpatialReferenceName()
                                         throws java.io.IOException,
                                                AutomationException

The name of the map's spatial reference.

Specified by:

getSpatialReferenceName in interface IARMap

Returns:

The sSpatialReference

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMapUnits

public int getMapUnits()
                throws java.io.IOException,
                       AutomationException

The geographical units of the map.

Specified by:

getMapUnits in interface IARMap

Returns:

A com.esri.arcgis.controls.esriARUnits constant

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDistanceUnits

public int getDistanceUnits()
                     throws java.io.IOException,
                            AutomationException

The distance units of the map.

Specified by:

getDistanceUnits in interface IARMap

Returns:

A com.esri.arcgis.controls.esriARUnits constant

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setExtent

public void setExtent(double xMin,
                      double yMin,
                      double xMax,
                      double yMax)
               throws java.io.IOException,
                      AutomationException

Sets the visible extent of the map.

Specified by:

setExtent in interface IARMap

Parameters:

xMin - The xMin (in)

yMin - The yMin (in)

xMax - The xMax (in)

yMax - The yMax (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getExtent

public void getExtent(double[] xMin,
                      double[] yMin,
                      double[] xMax,
                      double[] yMax)
               throws java.io.IOException,
                      AutomationException

The visible extent of the map.

Specified by:

getExtent in interface IARMap

Parameters:

xMin - The xMin (in/out: use single element array)

yMin - The yMin (in/out: use single element array)

xMax - The xMax (in/out: use single element array)

yMax - The yMax (in/out: use single element array)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getFullExtent

public void getFullExtent(double[] xMin,
                          double[] yMin,
                          double[] xMax,
                          double[] yMax)
                   throws java.io.IOException,
                          AutomationException

The extent of all the data within the map.

Specified by:

getFullExtent in interface IARMap

Parameters:

xMin - The xMin (in/out: use single element array)

yMin - The yMin (in/out: use single element array)

xMax - The xMax (in/out: use single element array)

yMax - The yMax (in/out: use single element array)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getReferenceScale

public double getReferenceScale()
                         throws java.io.IOException,
                                AutomationException

The reference scale of the map as a representative fraction.

Specified by:

getReferenceScale in interface IARMap

Returns:

The refScale

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

zoomIn

public void zoomIn(double factor)
            throws java.io.IOException,
                   AutomationException

Zooms in on the map by a factor.

Specified by:

zoomIn in interface IARMap

Parameters:

factor - The factor (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

zoomOut

public void zoomOut(double factor)
             throws java.io.IOException,
                    AutomationException

Zooms out on the map by a factor.

Specified by:

zoomOut in interface IARMap

Parameters:

factor - The factor (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

pan

public void pan(int direction,
                double screenPercentage)
         throws java.io.IOException,
                AutomationException

Pans the map by a factor in a specified direction.

Specified by:

pan in interface IARMap

Parameters:

direction - A com.esri.arcgis.controls.esriARDirection constant (in)

screenPercentage - The screenPercentage (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

centerAt

public void centerAt(double xCoord,
                     double yCoord)
              throws java.io.IOException,
                     AutomationException

Moves the center of the map to the specified point.

Specified by:

centerAt in interface IARMap

Parameters:

xCoord - The xCoord (in)

yCoord - The yCoord (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setRotation

public void setRotation(double mapRotation)
                 throws java.io.IOException,
                        AutomationException

The number of degrees the map display is rotated.

Specified by:

setRotation in interface IARMap

Parameters:

mapRotation - The mapRotation (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getRotation

public double getRotation()
                   throws java.io.IOException,
                          AutomationException

The number of degrees the map display is rotated.

Specified by:

getRotation in interface IARMap

Returns:

The mapRotation

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryARFeatures

public IARFeatureSet queryARFeatures(IARSearchDef pSearchDef)
                              throws java.io.IOException,
                                     AutomationException

Searches the map using a search definition and returns an ARFeatureSet.

Specified by:

queryARFeatures in interface IARMap

Parameters:

pSearchDef - A reference to a com.esri.arcgis.controls.IARSearchDef (in)

Returns:

A reference to a com.esri.arcgis.controls.IARFeatureSet

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

toMapPoint

public void toMapPoint(int x,
                       int y,
                       double[] xCoord,
                       double[] yCoord)
                throws java.io.IOException,
                       AutomationException

Converts a point in device coordinates (typically pixels) to coordinates in map units.

Specified by:

toMapPoint in interface IARMap

Parameters:

x - The x (in)

y - The y (in)

xCoord - The xCoord (in/out: use single element array)

yCoord - The yCoord (in/out: use single element array)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isCanUndoExtent

public boolean isCanUndoExtent()
                        throws java.io.IOException,
                               AutomationException

Indicates if there is a map extent that can be undone.

Specified by:

isCanUndoExtent in interface IARMap

Returns:

The bCanUndo

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

undoExtent

public void undoExtent()
                throws java.io.IOException,
                       AutomationException

Undo to the previous map extent in the stack.

Specified by:

undoExtent in interface IARMap

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isCanRedoExtent

public boolean isCanRedoExtent()
                        throws java.io.IOException,
                               AutomationException

Indicates if there is a map extent that can be redone.

Specified by:

isCanRedoExtent in interface IARMap

Returns:

The bCanRedo

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

redoExtent

public void redoExtent()
                throws java.io.IOException,
                       AutomationException

Redo the next map extent in the stack.

Specified by:

redoExtent in interface IARMap

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getInternalObject

public java.lang.Object getInternalObject()
                                   throws java.io.IOException,
                                          AutomationException

The internal ArcObjects IMap object.

Specified by:

getInternalObject in interface IARMap

Returns:

A reference to another Object (IUnknown)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getBookmarkCount

public int getBookmarkCount()
                     throws java.io.IOException,
                            AutomationException

The number of bookmarks in the map's bookmark collection.

Specified by:

getBookmarkCount in interface IARMap

Returns:

The pVal

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getBookmarkName

public java.lang.String getBookmarkName(int index)
                                 throws java.io.IOException,
                                        AutomationException

The name of the bookmark.

Specified by:

getBookmarkName in interface IARMap

Parameters:

index - The index (in)

Returns:

The pVal

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

zoomToBookmark

public void zoomToBookmark(java.lang.Object vBookmarkID)
                    throws java.io.IOException,
                           AutomationException

Zooms the map display to the bookmark.

Specified by:

zoomToBookmark in interface IARMap

Parameters:

vBookmarkID - A Variant (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

centerAtBookmark

public void centerAtBookmark(java.lang.Object vBookmarkID)
                      throws java.io.IOException,
                             AutomationException

Centers the map display on the bookmark.

Specified by:

centerAtBookmark in interface IARMap

Parameters:

vBookmarkID - A Variant (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

zoomToFullExtent

public void zoomToFullExtent()
                      throws java.io.IOException,
                             AutomationException

Zoom to the full extent of all data within the map.

Specified by:

zoomToFullExtent in interface IARMap

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getCustomProperty

public java.lang.Object getCustomProperty()
                                   throws java.io.IOException,
                                          AutomationException

A property to associate data with an object.

Specified by:

getCustomProperty in interface IARMap

Returns:

A Variant

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setCustomProperty

public void setCustomProperty(java.lang.Object pVal)
                       throws java.io.IOException,
                              AutomationException

A property to associate data with an object.

Specified by:

setCustomProperty in interface IARMap

Parameters:

pVal - A Variant (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

searchARFeatures

public IARFeatureCursor searchARFeatures(IARSearchDef pSearchDef)
                                  throws java.io.IOException,
                                         AutomationException

Searches the map using a search definition and returns an ARFeatureCursor.

Specified by:

searchARFeatures in interface IARMap

Parameters:

pSearchDef - A reference to a com.esri.arcgis.controls.IARSearchDef (in)

Returns:

A reference to a com.esri.arcgis.controls.IARFeatureCursor

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.