com.esri.arcgis.geodatabase
Class IGraphProxy

java.lang.Object
  extended by com.esri.arcgis.interop.Dispatch
      extended by com.esri.arcgis.geodatabase.IGraphProxy
All Implemented Interfaces:
IGraph, Externalizable, Serializable
Direct Known Subclasses:
IGeometricNetworkProxy

public class IGraphProxy
extends com.esri.arcgis.interop.Dispatch
implements IGraph, Serializable

Provides access to members that manage graphs.

Remarks

The IGraph interface contains methods and properties which are used in conjunction with geometric networks. Many of the methods, such as Add, Init, Split and Merge are called internally from within other methods. For these methods, there may be an analogous method or series of methods available, consult the specific help file for that method.

The NetworkLoader object should be used for creating or building of geometric networks, in place of the Graph or GeometricNetwork objects.

Since IGeometricNetwork inherits from IGraph, all the methods on IGraph are available to IGeometricNetwork

Product Availability

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

See Also:
IGeometricNetworkName, IGraph, IGraph.transformSet(com.esri.arcgis.system.ISet, int, com.esri.arcgis.geometry.IAffineTransformation2D), IGeometricNetwork.addJunctionWithSubsumption(com.esri.arcgis.geodatabase.ISimpleJunctionFeature, int, com.esri.arcgis.geodatabase.ISimpleJunctionFeature), IGraph.split(com.esri.arcgis.geodatabase.IEdgeFeature, com.esri.arcgis.geometry.IGeometry), IGeometricNetwork, 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
  IGraphProxy()
           
  IGraphProxy(Object obj)
           
protected IGraphProxy(Object obj, String iid)
           
 
Method Summary
 void add(IFeature newFeature)
          Adds the preexisting Feature to the graph.
 void addFeatureClass(IFeatureClass featureClass, String enabledFieldName, int role, String ancillaryRoleFieldName)
          Add the FeatureClass to this graph.
 void addListener(String iidStr, Object theListener, Object theSource)
           
 void deleteSet(ISet featuresToDelete)
          Removes the set of Feature from the graph.
 IDisplayFeedback getDisplayFeedback(IFeature feature, ISet features, IPoint point)
          The DisplayFeedback.
 IFeatureDataset getFeatureDataset()
          The FeatureDataset associated with the graph.
 void init(IFeatureDataset dataset, int graphID, String graphName, boolean buildNormalizedTables, boolean createGraph)
          Initializes the graph.
 boolean isVertexBasedStretching()
          The stretching model to nearest vertex (true) or junction (false) based stretching.
 IEnumFeature merge(IEnumFeature mergingFeatures)
          Merges the Features together, returning the newly created Feature.
 void removeListener(String iidStr, Object theListener)
           
 void setVertexBasedStretching(boolean vertexBased)
          The stretching model to nearest vertex (true) or junction (false) based stretching.
 ISet split(IEdgeFeature splittingEdge, IGeometry point)
          Split the feature.
 void transformSet(ISet features, int type, IAffineTransformation2D tranformation)
          Repositions all specified NetworkFeatures and any topologically connected NetworkFeatures.
 
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

IGraphProxy

public IGraphProxy()

IGraphProxy

public IGraphProxy(Object obj)
            throws IOException
Throws:
IOException

IGraphProxy

protected IGraphProxy(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

add

public void add(IFeature newFeature)
         throws IOException,
                AutomationException
Adds the preexisting Feature to the graph.

Remarks

The IGraph:Add method is meant for internal use only.

There is no need to call INetworkFeature::CreateNetworkElements or INetworkFeature::Connect as these are handled internally by IFeature::Store

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
add in interface IGraph
Parameters:
newFeature - A reference to a com.esri.arcgis.geodatabase.IFeature (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addFeatureClass

public void addFeatureClass(IFeatureClass featureClass,
                            String enabledFieldName,
                            int role,
                            String ancillaryRoleFieldName)
                     throws IOException,
                            AutomationException
Add the FeatureClass to this graph.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
addFeatureClass in interface IGraph
Parameters:
featureClass - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)
enabledFieldName - The enabledFieldName (in)
role - A com.esri.arcgis.geodatabase.esriNetworkClassAncillaryRole constant (in)
ancillaryRoleFieldName - The ancillaryRoleFieldName (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

deleteSet

public void deleteSet(ISet featuresToDelete)
               throws IOException,
                      AutomationException
Removes the set of Feature from the graph.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
deleteSet in interface IGraph
Parameters:
featuresToDelete - A reference to a com.esri.arcgis.system.ISet (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IWorkspaceEdit, ISpatialCacheManager, IWorkspaceEditEvents, Editor, IFeatureClass.createFeature()

getFeatureDataset

public IFeatureDataset getFeatureDataset()
                                  throws IOException,
                                         AutomationException
The FeatureDataset associated with the graph.

Remarks

Returns a reference to the feature dataset in which the graph exists.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getFeatureDataset in interface IGraph
Returns:
A reference to a com.esri.arcgis.geodatabase.IFeatureDataset
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getDisplayFeedback

public IDisplayFeedback getDisplayFeedback(IFeature feature,
                                           ISet features,
                                           IPoint point)
                                    throws IOException,
                                           AutomationException
The DisplayFeedback.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getDisplayFeedback in interface IGraph
Parameters:
feature - A reference to a com.esri.arcgis.geodatabase.IFeature (in)
features - A reference to a com.esri.arcgis.system.ISet (in)
point - A reference to a com.esri.arcgis.geometry.IPoint (in)
Returns:
A reference to a com.esri.arcgis.display.IDisplayFeedback
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

init

public void init(IFeatureDataset dataset,
                 int graphID,
                 String graphName,
                 boolean buildNormalizedTables,
                 boolean createGraph)
          throws IOException,
                 AutomationException
Initializes the graph.

Remarks

The IGraph::Init method is called internally during the process of creating a Geometric Network and should be called independently.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
init in interface IGraph
Parameters:
dataset - A reference to a com.esri.arcgis.geodatabase.IFeatureDataset (in)
graphID - The graphID (in)
graphName - The graphName (in)
buildNormalizedTables - The buildNormalizedTables (in)
createGraph - The createGraph (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

merge

public IEnumFeature merge(IEnumFeature mergingFeatures)
                   throws IOException,
                          AutomationException
Merges the Features together, returning the newly created Feature.

Remarks

The Merge method is not currently implemented.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
merge in interface IGraph
Parameters:
mergingFeatures - A reference to a com.esri.arcgis.geodatabase.IEnumFeature (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.IEnumFeature
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

split

public ISet split(IEdgeFeature splittingEdge,
                  IGeometry point)
           throws IOException,
                  AutomationException
Split the feature.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
split in interface IGraph
Parameters:
splittingEdge - A reference to a com.esri.arcgis.geodatabase.IEdgeFeature (in)
point - A reference to a com.esri.arcgis.geometry.IGeometry (in)
Returns:
A reference to a com.esri.arcgis.system.ISet
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IGeometricNetworkName, IWorkspaceEdit, IGraph, ISpatialCacheManager, IGraph.transformSet(com.esri.arcgis.system.ISet, int, com.esri.arcgis.geometry.IAffineTransformation2D), IGeometricNetwork.addJunctionWithSubsumption(com.esri.arcgis.geodatabase.ISimpleJunctionFeature, int, com.esri.arcgis.geodatabase.ISimpleJunctionFeature), IWorkspaceEditEvents, IGraph.split(com.esri.arcgis.geodatabase.IEdgeFeature, com.esri.arcgis.geometry.IGeometry), IGeometricNetwork, Editor, IFeatureClass.createFeature()

transformSet

public void transformSet(ISet features,
                         int type,
                         IAffineTransformation2D tranformation)
                  throws IOException,
                         AutomationException
Repositions all specified NetworkFeatures and any topologically connected NetworkFeatures.

Remarks

TransformSet will maintain connectivity between network features, there is no need to call Connect or RebuildConnectivity after TransformSet to establish connectivity. The type of stretching that is employed during TransformSet can be changed using the VertexBasedStretching property.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
transformSet in interface IGraph
Parameters:
features - A reference to a com.esri.arcgis.system.ISet (in)
type - A com.esri.arcgis.geodatabase.esriTransformType constant (in)
tranformation - A reference to a com.esri.arcgis.geometry.IAffineTransformation2D (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IWorkspaceEdit, ISpatialCacheManager, IWorkspaceEditEvents, Editor, IFeatureClass.createFeature()

isVertexBasedStretching

public boolean isVertexBasedStretching()
                                throws IOException,
                                       AutomationException
The stretching model to nearest vertex (true) or junction (false) based stretching.

Description

VertexBasedStretching controls the stretching model for the specified graph: vertex (true) or junction (false) based stretching. Vertex based stretching modifies features to the nearest vertex(es), while junction based stretching will proportionally modify the feature to the nearest junction(s).

The VertexBasedStretching property should be used to set or get the stretching model when edits are being made to the workspace using the IWorkspaceEdit interface. During an edit session in the Editor, VertexBasedStretching can be used to get the stretching model but cannot be used to set the stretching model. In this case IEditProperties::StretchGeometry overwrites VertexBasedStretching and should be used to set the desired stretching model.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
isVertexBasedStretching in interface IGraph
Returns:
The vertexBased
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INetworkUpdate, IForwardStar, IGraph, INetworkClass.getNetworkAncillaryRole(), INetworkWorkspace, INetworkClass.getGeometricNetwork(), INetworkClass.getFieldToWeightMapping(int), IUtilityNetwork, INetwork

setVertexBasedStretching

public void setVertexBasedStretching(boolean vertexBased)
                              throws IOException,
                                     AutomationException
The stretching model to nearest vertex (true) or junction (false) based stretching.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setVertexBasedStretching in interface IGraph
Parameters:
vertexBased - The vertexBased (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INetworkUpdate, IWorkspaceEdit, IForwardStar, ISpatialCacheManager, IGraph, INetworkClass.getNetworkAncillaryRole(), INetworkWorkspace, IWorkspaceEditEvents, INetworkClass.getGeometricNetwork(), Editor, INetworkClass.getFieldToWeightMapping(int), IFeatureClass.createFeature(), IUtilityNetwork, INetwork