com.esri.arcgis.controls
Class ARMap

java.lang.Object
  extended bycom.esri.arcgis.controls.ARMap
All Implemented Interfaces:
IARMap, java.io.Serializable

public class ARMap
extends java.lang.Object
implements IARMap

The ARMap container for the display of map data.

Product Availability

Available with ArcGIS Engine.

See Also:
Serialized Form

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.
 IARMap getAsIARMap()
          Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
 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.
 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.
 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 ARMap theARMap = (ARMap) obj;

Throws:
java.io.IOException - if there are interop problems
Method Detail

getAsIARMap

public IARMap getAsIARMap()
Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.


equals

public boolean equals(java.lang.Object o)
Compare this object with another


hashCode

public int hashCode()
the hashcode for this object


setMapScale

public void setMapScale(double mapScale)
                 throws java.io.IOException,
                        AutomationException
Description copied from interface: IARMap
The scale of the map as a representative fraction.

Specified by:
setMapScale in interface IARMap
Parameters:
mapScale - The mapScale (in)
Throws:
AutomationException - If the ArcObject component throws an exception.
java.io.IOException - If there are interop problems.

getMapScale

public double getMapScale()
                   throws java.io.IOException,
                          AutomationException
Description copied from interface: IARMap
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
Description copied from interface: IARMap
Redraws the map display area.

Specified by:
refresh in interface IARMap
Parameters:
refreshNow - The refreshNow (in, optional, pass false if not required)
Throws:
AutomationException - If the ArcObject component throws an exception.
java.io.IOException - If there are interop problems.

getName

public java.lang.String getName()
                         throws java.io.IOException,
                                AutomationException
Description copied from interface: IARMap
The name of the map.

Specified by:
getName in interface IARMap
Returns:
The sName
Throws:
AutomationException - If the ArcObject component throws an exception.
java.io.IOException - If there are interop problems.

getARLayerCount

public int getARLayerCount()
                    throws java.io.IOException,
                           AutomationException
Description copied from interface: IARMap
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
Description copied from interface: IARMap
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
Description copied from interface: IARMap
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
Description copied from interface: IARMap
The name of the map's spatial reference.

Specified by:
getSpatialReferenceName in interface IARMap
Returns:
The sSpatialReference
Throws:
AutomationException - If the ArcObject component throws an exception.
java.io.IOException - If there are interop problems.

getMapUnits

public int getMapUnits()
                throws java.io.IOException,
                       AutomationException
Description copied from interface: IARMap
The geographical units of the map.

Specified by:
getMapUnits in interface IARMap
Returns:
A com.esri.arcgis.controls.esriARUnits constant
Throws:
AutomationException - If the ArcObject component throws an exception.
java.io.IOException - If there are interop problems.

getDistanceUnits

public int getDistanceUnits()
                     throws java.io.IOException,
                            AutomationException
Description copied from interface: IARMap
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
Description copied from interface: IARMap
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:
AutomationException - If the ArcObject component throws an exception.
java.io.IOException - If there are interop problems.

getExtent

public void getExtent(double[] xMin,
                      double[] yMin,
                      double[] xMax,
                      double[] yMax)
               throws java.io.IOException,
                      AutomationException
Description copied from interface: IARMap
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
Description copied from interface: IARMap
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
Description copied from interface: IARMap
The reference scale of the map as a representative fraction.

Specified by:
getReferenceScale in interface IARMap
Returns:
The refScale
Throws:
AutomationException - If the ArcObject component throws an exception.
java.io.IOException - If there are interop problems.

zoomIn

public void zoomIn(double factor)
            throws java.io.IOException,
                   AutomationException
Description copied from interface: IARMap
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
Description copied from interface: IARMap
Zooms out on the map by a factor.

Specified by:
zoomOut in interface IARMap
Parameters:
factor - The factor (in)
Throws:
AutomationException - If the ArcObject component throws an exception.
java.io.IOException - If there are interop problems.

pan

public void pan(int direction,
                double screenPercentage)
         throws java.io.IOException,
                AutomationException
Description copied from interface: IARMap
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
Description copied from interface: IARMap
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
Description copied from interface: IARMap
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
Description copied from interface: IARMap
The number of degrees the map display is rotated.

Specified by:
getRotation in interface IARMap
Returns:
The mapRotation
Throws:
AutomationException - If the ArcObject component throws an exception.
java.io.IOException - If there are interop problems.

queryARFeatures

public IARFeatureSet queryARFeatures(IARSearchDef pSearchDef)
                              throws java.io.IOException,
                                     AutomationException
Description copied from interface: IARMap
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:
AutomationException - If the ArcObject component throws an exception.
java.io.IOException - If there are interop problems.

toMapPoint

public void toMapPoint(int x,
                       int y,
                       double[] xCoord,
                       double[] yCoord)
                throws java.io.IOException,
                       AutomationException
Description copied from interface: IARMap
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
Description copied from interface: IARMap
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
Description copied from interface: IARMap
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
Description copied from interface: IARMap
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
Description copied from interface: IARMap
Redo the next map extent in the stack.

Specified by:
redoExtent in interface IARMap
Throws:
AutomationException - If the ArcObject component throws an exception.
java.io.IOException - If there are interop problems.

getInternalObject

public java.lang.Object getInternalObject()
                                   throws java.io.IOException,
                                          AutomationException
Description copied from interface: IARMap
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
Description copied from interface: IARMap
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
Description copied from interface: IARMap
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
Description copied from interface: IARMap
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
Description copied from interface: IARMap
Centers the map display on the bookmark.

Specified by:
centerAtBookmark in interface IARMap
Parameters:
vBookmarkID - A Variant (in)
Throws:
AutomationException - If the ArcObject component throws an exception.
java.io.IOException - If there are interop problems.

zoomToFullExtent

public void zoomToFullExtent()
                      throws java.io.IOException,
                             AutomationException
Description copied from interface: IARMap
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
Description copied from interface: IARMap
A property to associate data with an object.

Specified by:
getCustomProperty in interface IARMap
Returns:
A Variant
Throws:
AutomationException - If the ArcObject component throws an exception.
java.io.IOException - If there are interop problems.

setCustomProperty

public void setCustomProperty(java.lang.Object pVal)
                       throws java.io.IOException,
                              AutomationException
Description copied from interface: IARMap
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
Description copied from interface: IARMap
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.