com.esri.arcgis.arcglobe
Class IGMxDocumentProxy

java.lang.Object
  extended by com.esri.arcgis.interop.Dispatch
      extended by com.esri.arcgis.arcglobe.IGMxDocumentProxy
All Implemented Interfaces:
IGMxDocument, Externalizable, Serializable

public class IGMxDocumentProxy
extends com.esri.arcgis.interop.Dispatch
implements IGMxDocument, Serializable

Provides access to members that control the ArcGlobe Document object.

Description

The IGMxDocument is a starting point for accessing most of the ArcGlobe objects. This interface allows you to manipulate ArcGlobe document specific properties and methods, such as storing a document with relative paths, changing the search tolerance in pixels, saving a preview of the globe document to be viewed in ArcCatalog, loading and saving ArcGlobe animation files (*.aga files), adding a layer in the TOC, and removing all the layers in the TOC of a globe document.

Remarks

Obtain a reference to IGMxDocument via IApplication::Document.

When To Use

This interface is a starting point for getting a handle to other objects in ArcGlobe desktop application. Almost every ArcGlobe desktop customization uses IGMxDocument one way or another.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

See Also:
Serialized Form

Field Summary
 boolean noncastable
           
 
Fields inherited from class com.esri.arcgis.interop.Dispatch
DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, objRef
 
Constructor Summary
  IGMxDocumentProxy()
           
  IGMxDocumentProxy(Object obj)
           
protected IGMxDocumentProxy(Object obj, String iid)
           
 
Method Summary
 void addLayer(ILayer layer)
          Adds a layer to the current focus map.
 void addListener(String iidStr, Object theListener, Object theSource)
           
 IContentsView2 getContentsView(int index)
          The contents view at the specified index.
 int getContentsViewCount()
          The number of contents views in the document.
 Object getContextItem()
          The item that is selected or was last right-clicked.
 IContentsView2 getCurrentContentsView()
          The current contents view of the document.
 IColor getDefaultColor(int type)
          The default color for the given type.
 IScene getScene()
          The scene.
 int getSearchTolerancePixels()
          The global search tolerance in pixels for selection.
 Object getSelectedItem()
          The selected item in the layer control.
 ILayer getSelectedLayer()
          The selected layer in the layer control.
 boolean isRelativePaths()
          Indicates if path names are stored relative to the document.
 boolean isSavePreview()
          Indicates if a preview image is saved in the document.
 void removeAllLayers()
          Removes all layers.
 void removeListener(String iidStr, Object theListener)
           
 void setContextItem(Object item)
          The item that is selected or was last right-clicked.
 void setCurrentContentsViewByRef(IContentsView2 view)
          The current contents view of the document.
 void setDefaultColor(int type, IColor color)
          The default color for the given type.
 void setDelayUpdateContents(boolean rhs1)
          Indicates whether to ignore document update notifications.
 void setRelativePaths(boolean relPaths)
          Indicates if path names are stored relative to the document.
 void setSavePreview(boolean savePreview)
          Indicates if a preview image is saved in the document.
 void setScene(IScene pScene)
          The scene.
 void setSearchTolerancePixels(int tol)
          The global search tolerance in pixels for selection.
 void updateContents()
          Notifies the document that the contents have been updated.
 
Methods inherited from class com.esri.arcgis.interop.Dispatch
bindUsingMoniker, constructVtblPosTable, convertToNative, cookieForListener, createDispatch, createObjrefMonikerDisplayName, equals, getActiveObject, getActiveObject, getDefaultProperty, getDispatchIdOfName, getLastErrorCode, getMtsObjectContext, getObjRef, getPropertyByName, getPropertyByName, getVtblPos, hashCode, initDispatch, invoke, invokeMethodByName, invokeMethodByName, invokeMethodByName, invokePropertyGetByName, invokePropertyPutByName, invokePropertyPutByRefByName, isNativeMode, isObjRef, optimizedVtblInvoke, queryInterface, readExternal, release, setNativeMode, setPropertyByName, toString, vtblInvoke, writeExternal
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

noncastable

public boolean noncastable
Constructor Detail

IGMxDocumentProxy

public IGMxDocumentProxy()

IGMxDocumentProxy

public IGMxDocumentProxy(Object obj)
                  throws IOException
Throws:
IOException

IGMxDocumentProxy

protected IGMxDocumentProxy(Object obj,
                            String iid)
                     throws IOException
Throws:
IOException
Method Detail

addListener

public void addListener(String iidStr,
                        Object theListener,
                        Object theSource)
                 throws IOException
Overrides:
addListener in class com.esri.arcgis.interop.Dispatch
Throws:
IOException

removeListener

public void removeListener(String iidStr,
                           Object theListener)
                    throws IOException
Overrides:
removeListener in class com.esri.arcgis.interop.Dispatch
Throws:
IOException

getSelectedLayer

public ILayer getSelectedLayer()
                        throws IOException,
                               AutomationException
The selected layer in the layer control.

Remarks

This property provides a handle to the currently selected layer in the table of contents.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
getSelectedLayer in interface IGMxDocument
Returns:
A reference to a com.esri.arcgis.carto.ILayer
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getSelectedItem

public Object getSelectedItem()
                       throws IOException,
                              AutomationException
The selected item in the layer control.

Remarks

Use the SelectedITem property to obtain a reference to the selected item in the TOC. This property returns an IUnknown because an item in the TOC can be any number f things. For example, when working with the Display tab the reference can be one of the layers, if a layer is selected.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
getSelectedItem in interface IGMxDocument
Returns:
A reference to another Object (IUnknown)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getContextItem

public Object getContextItem()
                      throws IOException,
                             AutomationException
The item that is selected or was last right-clicked.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
getContextItem in interface IGMxDocument
Returns:
A reference to another Object (IUnknown)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setContextItem

public void setContextItem(Object item)
                    throws IOException,
                           AutomationException
The item that is selected or was last right-clicked.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
setContextItem in interface IGMxDocument
Parameters:
item - A reference to another Object (IUnknown) (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addLayer

public void addLayer(ILayer layer)
              throws IOException,
                     AutomationException
Adds a layer to the current focus map.

Remarks

This method is a shortcut to the AddLayer method on the IScene (IScene::AddLayer).

Note: Using IGMxDocument::AddLayer, the layer is added as draped on the globe surface, by default.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
addLayer in interface IGMxDocument
Parameters:
layer - A reference to a com.esri.arcgis.carto.ILayer (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

removeAllLayers

public void removeAllLayers()
                     throws IOException,
                            AutomationException
Removes all layers.

Remarks

RemoveAllLayers deletes all the layers present in the Table Of Contents of the current ArcGlobe document and therefore, should be carefully used.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
removeAllLayers in interface IGMxDocument
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

updateContents

public void updateContents()
                    throws IOException,
                           AutomationException
Notifies the document that the contents have been updated.

Remarks

Use UpdateContents to automatically refresh the active TOC.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
updateContents in interface IGMxDocument
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setDelayUpdateContents

public void setDelayUpdateContents(boolean rhs1)
                            throws IOException,
                                   AutomationException
Indicates whether to ignore document update notifications.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
setDelayUpdateContents in interface IGMxDocument
Parameters:
rhs1 - The rhs1 (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getSearchTolerancePixels

public int getSearchTolerancePixels()
                             throws IOException,
                                    AutomationException
The global search tolerance in pixels for selection.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
getSearchTolerancePixels in interface IGMxDocument
Returns:
The tol
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setSearchTolerancePixels

public void setSearchTolerancePixels(int tol)
                              throws IOException,
                                     AutomationException
The global search tolerance in pixels for selection.

Remarks

The SearchTolerancePixels method changes the search tolerance in pixels. This is similar to changing the search tolerance on the Selection Options dialog on the user interface.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
setSearchTolerancePixels in interface IGMxDocument
Parameters:
tol - The tol (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getDefaultColor

public IColor getDefaultColor(int type)
                       throws IOException,
                              AutomationException
The default color for the given type.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Specified by:
getDefaultColor in interface IGMxDocument
Parameters:
type - A com.esri.arcgis.arcmapui.esriMxDefaultColorTypes constant (in)
Returns:
A reference to a com.esri.arcgis.display.IColor
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setDefaultColor

public void setDefaultColor(int type,
                            IColor color)
                     throws IOException,
                            AutomationException
The default color for the given type.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Specified by:
setDefaultColor in interface IGMxDocument
Parameters:
type - A com.esri.arcgis.arcmapui.esriMxDefaultColorTypes constant (in)
color - A reference to a com.esri.arcgis.display.IColor (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getScene

public IScene getScene()
                throws IOException,
                       AutomationException
The scene.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
getScene in interface IGMxDocument
Returns:
A reference to a com.esri.arcgis.analyst3d.IScene
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setScene

public void setScene(IScene pScene)
              throws IOException,
                     AutomationException
The scene.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
setScene in interface IGMxDocument
Parameters:
pScene - A reference to a com.esri.arcgis.analyst3d.IScene (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isRelativePaths

public boolean isRelativePaths()
                        throws IOException,
                               AutomationException
Indicates if path names are stored relative to the document.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
isRelativePaths in interface IGMxDocument
Returns:
The relPaths
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setRelativePaths

public void setRelativePaths(boolean relPaths)
                      throws IOException,
                             AutomationException
Indicates if path names are stored relative to the document.

Remarks

RelativePaths can be set to True for storing a document with relative paths. Setting the property to False stores the document with full paths.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
setRelativePaths in interface IGMxDocument
Parameters:
relPaths - The relPaths (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isSavePreview

public boolean isSavePreview()
                      throws IOException,
                             AutomationException
Indicates if a preview image is saved in the document.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
isSavePreview in interface IGMxDocument
Returns:
The savePreview
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setSavePreview

public void setSavePreview(boolean savePreview)
                    throws IOException,
                           AutomationException
Indicates if a preview image is saved in the document.

Remarks

The SavePreview property specifies whether or not a thumbnail image of the globe is displayed in ArcCatalog or not, when browsing globe documents. For saving a preview of the current ArcGlobe document, this proerty should be set to True.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
setSavePreview in interface IGMxDocument
Parameters:
savePreview - The savePreview (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getCurrentContentsView

public IContentsView2 getCurrentContentsView()
                                      throws IOException,
                                             AutomationException
The current contents view of the document.

Description

A contents view is a tab in the table of contents. ArcGlobe has three contents views: Display (TOCGMxDisplayView), Source (TOCGMxCatalogView), and Type (TOCGMxTypeView). Only one contents view can be active at a time. Use this property to set the current contents view and to get a reference to the current contents view. Setting the current contents view automatically calls IContentsView::Refresh.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
getCurrentContentsView in interface IGMxDocument
Returns:
A reference to a com.esri.arcgis.arcmapui.IContentsView2
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setCurrentContentsViewByRef

public void setCurrentContentsViewByRef(IContentsView2 view)
                                 throws IOException,
                                        AutomationException
The current contents view of the document.

Remarks

Use the CurrentContentsView to set the current contents view and to get a reference to the current contents view. Setting the current contents view automatically refreshes the table of contents (IContentsView::Refresh).

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
setCurrentContentsViewByRef in interface IGMxDocument
Parameters:
view - A reference to a com.esri.arcgis.arcmapui.IContentsView2 (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getContentsViewCount

public int getContentsViewCount()
                         throws IOException,
                                AutomationException
The number of contents views in the document.

Remarks

A contents view is a tab in the table of contents. ArcGlobe has three contents views: Display (TOCGMxDisplayView), Source (TOCGMxCatalogView), and Type (TOCGMxTypeView). Only one contents view can be active at a time. This property returns the number of contents views registered in the ESRI Contents Views component category.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Supported Platforms

Windows

Specified by:
getContentsViewCount in interface IGMxDocument
Returns:
The count
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getContentsView

public IContentsView2 getContentsView(int index)
                               throws IOException,
                                      AutomationException
The contents view at the specified index.

Product Availability

Available with ArcGIS Desktop. Requires 3D Analyst Extension.

Specified by:
getContentsView in interface IGMxDocument
Parameters:
index - The index (in)
Returns:
A reference to a com.esri.arcgis.arcmapui.IContentsView2
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.