com.esri.arcgis.geodatabase

Interface ITopologyGraph

All Superinterfaces:

java.io.Serializable

All Known Implementing Classes:

ITopologyGraphProxy

public interface ITopologyGraph
extends java.io.Serializable

COM Interface 'ITopologyGraph'. Generated 9/24/2024 11:01:29 AM from 'X:\ArcGIS\com\server\esriGeoDatabase.tlb'

Description: 'Provides access to members that control the topology graph.' 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 =

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	IID Deprecated. Internal use only
static int	IID4adc1017_3c78_434b_a32c_1817a42eb857
static int	xxDummy Deprecated. Internal use only

Method Summary

Modifier and Type	Method and Description
void	build(IEnvelope extent, boolean preserveSelection) Creates topo elements from all topology feature classes covering the specified map extent.
void	buildFromPolygon(IPolygon extent, boolean preserveSelection) Creates topo elements from all topology feature classes intersecting the specified polygon.
void	deleteEdge(ITopologyEdge edge) Deletes the specified edge from its containing topology graph.
void	deletePseudoNodesFromSelection() Removes pseudo-nodes by combining edges incident on such nodes.
void	determineNodeDegree() Nodes located outside a polygonal build extent do not have a known degree (valence).
boolean	enumHitTest(int whichElements, IPoint queryPoint, double searchRadius, IEnumTGHitInfo[] hitInfo) Locates all elements of the graph within searchRadius units of the query point; whichElements is a bitwise combination of esriTopologyElement values.
IEnvelope	getBuildExtent() The extent used to build the graph.
IPolygon	getBuildPolygonExtent() The polygon used to determine the contents of the topology graph.
IEnumTopologyEdge	getEdges() The enumerator that provides access to all the edges.
IEnumTopologyEdge	getEdgeSelection() The enumerator for the selected edges of the topology.
IEnvelope	getExtent() The current extent of all topological elements in the graph.
IEnumTopologyNode	getNodes() The enumerator that provides access to all the nodes.
IEnumTopologyNode	getNodeSelection() The enumerator for the selected nodes of the topology.
IEnumTopologyEdge	getParentEdges(IFeatureClass featureClass, long oID) Returns the set of edges corresponding to the specified polyline or polygon feature.
IGeometry	getParentGeometry(IFeatureClass featureClass, long oID) Creates a geometry corresponding to the current set of edges/nodes owned by the specified parent.
IEnumTopologyNode	getParentNodes(IFeatureClass featureClass, long oID) Returns the set of nodes corresponding to the specified point or multipoint feature.
int	getSelectionCount(int whichElements) The count of selected elements of the specified types; whichElements is a bitwise combination of esriTopologyElement values.
IEnvelope	getSelectionExtent(int whichElements, boolean includeAdjacent) The extent of the selected subset of the graph, optionally includes extent of all edges incident on selected nodes (or on nodes incident on selected edges); whichElements is a bitwise combination of esriTopologyElement values.
IEnumTopologyParent	getSelectionParents() The feature class and oid of each parent of the selected set of elements.
boolean	hitTest(int whichElements, IPoint queryPoint, double searchRadius, IPoint hitPoint, double[] hitDistance, ITopologyElement[] hitElement) Locates an element of the graph nearest to the query point that is also within searchRadius units of it; whichElements is a bitwise combination of esriTopologyElement values.
boolean	hitTestSelection(int whichElements, IPoint queryPoint, double searchRadius, IPoint hitPoint, double[] hitDistance, ITopologyElement[] hitElement) Locates an element of the graph's selection nearest to the query point that is also within searchRadius units of it; whichElements is a bitwise combination of esriTopologyElement values.
boolean	isHasElement(ITopologyElement element) Indicates if the topology graph contains the specified element.
boolean	isHasPseudoNodes() Indicates if the topology graph contains pseudo nodes.
boolean	isPosting() Indicates if the topology graph is posting.
void	mergeSelectedEdges() Merge a connected sequence of selected edges that has the same feature parent set.
void	post(IEnvelope[] invalidArea) Posts changes to topology elements back to their originating features.
boolean	reshapeEdgeGeometry(ITopologyEdge edge, IPath reshapeGeometry) Reshapes (and possibly reinterpolates) the geometry of the specified edge.
boolean	select(int selectHow, ITopologyElement element) Adds the specified element to the selected subset of the graph.
void	selectByGeometry(int whichElements, int selectHow, IGeometry geometry) Selects nodes and/or edges that intersect the specified geometry; whichElements is a bitwise combination of esriTopologyElement values.
void	setEdgeGeometry(ITopologyEdge edge, IPath geometry) Assigns the path geometry to the specified edge.
void	setEmpty() Removes all topological elements from the graph.
boolean	setParentSelected(IFeatureClass featureClass, long oID, boolean selected) Selects parents of edges.
void	setSelectionEmpty(int whichType) Clears the specified selection set: whichType is a bitwise combination of esriTopologyNode, esriTopologyEdge.
void	splitEdgeAtDistance(ITopologyEdge edge, double distance, boolean asRatio, double tolerance, ITopologyEdge[] from, ITopologyNode[] mid, ITopologyEdge[] to) Adds a pseudo-node to the edge at the specified distance along the edge.
void	splitEdgeAtPoint(ITopologyEdge edge, IPoint splitPoint, double tolerance, ITopologyEdge[] from, ITopologyNode[] mid, ITopologyEdge[] to) Adds a pseudo-node to the edge at the point on the edge closest to the input point.
void	splitMoveNode(ITopologyNode nodeToSplit, IPoint moveTo, boolean proportionalStretch) Change graph connectivity: Moves the specified node, along with any selected edges incident on it.
void	transformSelection(int direction, ITransformation transformation, boolean proportionalStretch) Applies the specified transformation to the selected elements of the graph.

Field Detail

IID4adc1017_3c78_434b_a32c_1817a42eb857

static final int IID4adc1017_3c78_434b_a32c_1817a42eb857

See Also:

Constant Field Values

xxDummy

static final int xxDummy

Deprecated. Internal use only

See Also:

Constant Field Values

IID

static final java.lang.String IID

Deprecated. Internal use only

See Also:

Constant Field Values

Method Detail

setEmpty

void setEmpty()
       throws java.io.IOException,
              AutomationException

Removes all topological elements from the graph. Any client-side references to topo elements that came from this graph should be released.

Throws:

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

AutomationException - If the ArcObject component throws an exception.

setSelectionEmpty

void setSelectionEmpty(int whichType)
                throws java.io.IOException,
                       AutomationException

Clears the specified selection set: whichType is a bitwise combination of esriTopologyNode, esriTopologyEdge.

Parameters:

whichType - The whichType (in)

Throws:

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

AutomationException - If the ArcObject component throws an exception.

build

void build(IEnvelope extent,
           boolean preserveSelection)
    throws java.io.IOException,
           AutomationException

Creates topo elements from all topology feature classes covering the specified map extent.

Parameters:

extent - A reference to a com.esri.arcgis.geometry.IEnvelope (in)

preserveSelection - The preserveSelection (in)

Throws:

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

AutomationException - If the ArcObject component throws an exception.

getExtent

IEnvelope getExtent()
             throws java.io.IOException,
                    AutomationException

The current extent of all topological elements in the graph. This may be different than the extent used to build the graph.

Returns:

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

Throws:

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

AutomationException - If the ArcObject component throws an exception.

getBuildExtent

IEnvelope getBuildExtent()
                  throws java.io.IOException,
                         AutomationException

The extent used to build the graph.

Returns:

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

Throws:

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

AutomationException - If the ArcObject component throws an exception.

hitTest

boolean hitTest(int whichElements,
                IPoint queryPoint,
                double searchRadius,
                IPoint hitPoint,
                double[] hitDistance,
                ITopologyElement[] hitElement)
         throws java.io.IOException,
                AutomationException

Locates an element of the graph nearest to the query point that is also within searchRadius units of it; whichElements is a bitwise combination of esriTopologyElement values.

Parameters:

whichElements - The whichElements (in)

queryPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)

searchRadius - The searchRadius (in)

hitPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)

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

hitElement - A reference to a com.esri.arcgis.geodatabase.ITopologyElement (out: use single element array)

Returns:

The hit

Throws:

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

AutomationException - If the ArcObject component throws an exception.

enumHitTest

boolean enumHitTest(int whichElements,
                    IPoint queryPoint,
                    double searchRadius,
                    IEnumTGHitInfo[] hitInfo)
             throws java.io.IOException,
                    AutomationException

Locates all elements of the graph within searchRadius units of the query point; whichElements is a bitwise combination of esriTopologyElement values.

Parameters:

whichElements - The whichElements (in)

queryPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)

searchRadius - The searchRadius (in)

hitInfo - A reference to a com.esri.arcgis.geodatabase.IEnumTGHitInfo (out: use single element array)

Returns:

The hit

Throws:

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

AutomationException - If the ArcObject component throws an exception.

getSelectionCount

int getSelectionCount(int whichElements)
               throws java.io.IOException,
                      AutomationException

The count of selected elements of the specified types; whichElements is a bitwise combination of esriTopologyElement values.

Parameters:

whichElements - The whichElements (in)

Returns:

The count

Throws:

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

AutomationException - If the ArcObject component throws an exception.

select

boolean select(int selectHow,
               ITopologyElement element)
        throws java.io.IOException,
               AutomationException

Adds the specified element to the selected subset of the graph.

Parameters:

selectHow - A com.esri.arcgis.geodatabase.esriTopologySelectionResultEnum constant (in)

element - A reference to a com.esri.arcgis.geodatabase.ITopologyElement (in)

Returns:

The selectionChanged

Throws:

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

AutomationException - If the ArcObject component throws an exception.

getNodeSelection

IEnumTopologyNode getNodeSelection()
                            throws java.io.IOException,
                                   AutomationException

The enumerator for the selected nodes of the topology.

Returns:

A reference to a com.esri.arcgis.geodatabase.IEnumTopologyNode

Throws:

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

AutomationException - If the ArcObject component throws an exception.

getEdgeSelection

IEnumTopologyEdge getEdgeSelection()
                            throws java.io.IOException,
                                   AutomationException

The enumerator for the selected edges of the topology.

Returns:

A reference to a com.esri.arcgis.geodatabase.IEnumTopologyEdge

Throws:

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

AutomationException - If the ArcObject component throws an exception.

getSelectionExtent

IEnvelope getSelectionExtent(int whichElements,
                             boolean includeAdjacent)
                      throws java.io.IOException,
                             AutomationException

The extent of the selected subset of the graph, optionally includes extent of all edges incident on selected nodes (or on nodes incident on selected edges); whichElements is a bitwise combination of esriTopologyElement values.

Parameters:

whichElements - The whichElements (in)

includeAdjacent - The includeAdjacent (in)

Returns:

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

Throws:

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

AutomationException - If the ArcObject component throws an exception.

transformSelection

void transformSelection(int direction,
                        ITransformation transformation,
                        boolean proportionalStretch)
                 throws java.io.IOException,
                        AutomationException

Applies the specified transformation to the selected elements of the graph.

Parameters:

direction - A com.esri.arcgis.geometry.esriTransformDirection constant (in)

transformation - A reference to a com.esri.arcgis.geometry.ITransformation (in)

proportionalStretch - The proportionalStretch (in)

Throws:

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

AutomationException - If the ArcObject component throws an exception.

post

void post(IEnvelope[] invalidArea)
   throws java.io.IOException,
          AutomationException

Posts changes to topology elements back to their originating features. Must be used within an edit session and edit operation.

Parameters:

invalidArea - A reference to a com.esri.arcgis.geometry.IEnvelope (out: use single element array)

Throws:

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

AutomationException - If the ArcObject component throws an exception.

isPosting

boolean isPosting()
           throws java.io.IOException,
                  AutomationException

Indicates if the topology graph is posting.

Returns:

The posting

Throws:

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

AutomationException - If the ArcObject component throws an exception.

reshapeEdgeGeometry

boolean reshapeEdgeGeometry(ITopologyEdge edge,
                            IPath reshapeGeometry)
                     throws java.io.IOException,
                            AutomationException

Reshapes (and possibly reinterpolates) the geometry of the specified edge.

Parameters:

edge - A reference to a com.esri.arcgis.geodatabase.ITopologyEdge (in)

reshapeGeometry - A reference to a com.esri.arcgis.geometry.IPath (in)

Returns:

The reshaped

Throws:

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

AutomationException - If the ArcObject component throws an exception.

getSelectionParents

IEnumTopologyParent getSelectionParents()
                                 throws java.io.IOException,
                                        AutomationException

The feature class and oid of each parent of the selected set of elements.

Returns:

A reference to a com.esri.arcgis.geodatabase.IEnumTopologyParent

Throws:

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

AutomationException - If the ArcObject component throws an exception.

setParentSelected

boolean setParentSelected(IFeatureClass featureClass,
                          long oID,
                          boolean selected)
                   throws java.io.IOException,
                          AutomationException

Selects parents of edges. SUbsequent edits to those edges will only be posted back to selected parents.

Parameters:

featureClass - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)

oID - Signed 64-bit int (in)

selected - The selected (in)

Returns:

The edgeSelectionChanged

Throws:

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

AutomationException - If the ArcObject component throws an exception.

getParentGeometry

IGeometry getParentGeometry(IFeatureClass featureClass,
                            long oID)
                     throws java.io.IOException,
                            AutomationException

Creates a geometry corresponding to the current set of edges/nodes owned by the specified parent.

Parameters:

featureClass - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)

oID - Signed 64-bit int (in)

Returns:

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

Throws:

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

AutomationException - If the ArcObject component throws an exception.

splitMoveNode

void splitMoveNode(ITopologyNode nodeToSplit,
                   IPoint moveTo,
                   boolean proportionalStretch)
            throws java.io.IOException,
                   AutomationException

Change graph connectivity: Moves the specified node, along with any selected edges incident on it. A copy of the node, along with unselected edges, remains in the original location.

Parameters:

nodeToSplit - A reference to a com.esri.arcgis.geodatabase.ITopologyNode (in)

moveTo - A reference to a com.esri.arcgis.geometry.IPoint (in)

proportionalStretch - The proportionalStretch (in)

Throws:

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

AutomationException - If the ArcObject component throws an exception.

splitEdgeAtPoint

void splitEdgeAtPoint(ITopologyEdge edge,
                      IPoint splitPoint,
                      double tolerance,
                      ITopologyEdge[] from,
                      ITopologyNode[] mid,
                      ITopologyEdge[] to)
               throws java.io.IOException,
                      AutomationException

Adds a pseudo-node to the edge at the point on the edge closest to the input point. The node gets created at an existing vertex if one is located within the specified tolerance of the split point.

Parameters:

edge - A reference to a com.esri.arcgis.geodatabase.ITopologyEdge (in)

splitPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)

tolerance - The tolerance (in)

from - A reference to a com.esri.arcgis.geodatabase.ITopologyEdge (out: use single element array)

mid - A reference to a com.esri.arcgis.geodatabase.ITopologyNode (out: use single element array)

to - A reference to a com.esri.arcgis.geodatabase.ITopologyEdge (out: use single element array)

Throws:

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

AutomationException - If the ArcObject component throws an exception.

splitEdgeAtDistance

void splitEdgeAtDistance(ITopologyEdge edge,
                         double distance,
                         boolean asRatio,
                         double tolerance,
                         ITopologyEdge[] from,
                         ITopologyNode[] mid,
                         ITopologyEdge[] to)
                  throws java.io.IOException,
                         AutomationException

Adds a pseudo-node to the edge at the specified distance along the edge. The node gets created at an existing vertex if one is located within the specified tolerance.

Parameters:

edge - A reference to a com.esri.arcgis.geodatabase.ITopologyEdge (in)

distance - The distance (in)

asRatio - The asRatio (in)

tolerance - The tolerance (in)

from - A reference to a com.esri.arcgis.geodatabase.ITopologyEdge (out: use single element array)

mid - A reference to a com.esri.arcgis.geodatabase.ITopologyNode (out: use single element array)

to - A reference to a com.esri.arcgis.geodatabase.ITopologyEdge (out: use single element array)

Throws:

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

AutomationException - If the ArcObject component throws an exception.

setEdgeGeometry

void setEdgeGeometry(ITopologyEdge edge,
                     IPath geometry)
              throws java.io.IOException,
                     AutomationException

Assigns the path geometry to the specified edge. Reinterpolatex vertex attributes for the edge if any exist.

Parameters:

edge - A reference to a com.esri.arcgis.geodatabase.ITopologyEdge (in)

geometry - A reference to a com.esri.arcgis.geometry.IPath (in)

Throws:

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

AutomationException - If the ArcObject component throws an exception.

deletePseudoNodesFromSelection

void deletePseudoNodesFromSelection()
                             throws java.io.IOException,
                                    AutomationException

Removes pseudo-nodes by combining edges incident on such nodes. Edges and nodes in the current selection are considered.

Throws:

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

AutomationException - If the ArcObject component throws an exception.

deleteEdge

void deleteEdge(ITopologyEdge edge)
         throws java.io.IOException,
                AutomationException

Deletes the specified edge from its containing topology graph.

Parameters:

edge - A reference to a com.esri.arcgis.geodatabase.ITopologyEdge (in)

Throws:

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

AutomationException - If the ArcObject component throws an exception.

selectByGeometry

void selectByGeometry(int whichElements,
                      int selectHow,
                      IGeometry geometry)
               throws java.io.IOException,
                      AutomationException

Selects nodes and/or edges that intersect the specified geometry; whichElements is a bitwise combination of esriTopologyElement values.

Parameters:

whichElements - The whichElements (in)

selectHow - A com.esri.arcgis.geodatabase.esriTopologySelectionResultEnum constant (in)

geometry - A reference to a com.esri.arcgis.geometry.IGeometry (in)

Throws:

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

AutomationException - If the ArcObject component throws an exception.

getParentNodes

IEnumTopologyNode getParentNodes(IFeatureClass featureClass,
                                 long oID)
                          throws java.io.IOException,
                                 AutomationException

Returns the set of nodes corresponding to the specified point or multipoint feature.

Parameters:

featureClass - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)

oID - Signed 64-bit int (in)

Returns:

A reference to a com.esri.arcgis.geodatabase.IEnumTopologyNode

Throws:

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

AutomationException - If the ArcObject component throws an exception.

getParentEdges

IEnumTopologyEdge getParentEdges(IFeatureClass featureClass,
                                 long oID)
                          throws java.io.IOException,
                                 AutomationException

Returns the set of edges corresponding to the specified polyline or polygon feature.

Parameters:

featureClass - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)

oID - Signed 64-bit int (in)

Returns:

A reference to a com.esri.arcgis.geodatabase.IEnumTopologyEdge

Throws:

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

AutomationException - If the ArcObject component throws an exception.

getEdges

IEnumTopologyEdge getEdges()
                    throws java.io.IOException,
                           AutomationException

The enumerator that provides access to all the edges.

Returns:

A reference to a com.esri.arcgis.geodatabase.IEnumTopologyEdge

Throws:

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

AutomationException - If the ArcObject component throws an exception.

getNodes

IEnumTopologyNode getNodes()
                    throws java.io.IOException,
                           AutomationException

The enumerator that provides access to all the nodes.

Returns:

A reference to a com.esri.arcgis.geodatabase.IEnumTopologyNode

Throws:

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

AutomationException - If the ArcObject component throws an exception.

isHasElement

boolean isHasElement(ITopologyElement element)
              throws java.io.IOException,
                     AutomationException

Indicates if the topology graph contains the specified element.

Parameters:

element - A reference to a com.esri.arcgis.geodatabase.ITopologyElement (in)

Returns:

The hasElement

Throws:

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

AutomationException - If the ArcObject component throws an exception.

hitTestSelection

boolean hitTestSelection(int whichElements,
                         IPoint queryPoint,
                         double searchRadius,
                         IPoint hitPoint,
                         double[] hitDistance,
                         ITopologyElement[] hitElement)
                  throws java.io.IOException,
                         AutomationException

Locates an element of the graph's selection nearest to the query point that is also within searchRadius units of it; whichElements is a bitwise combination of esriTopologyElement values.

Parameters:

whichElements - The whichElements (in)

queryPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)

searchRadius - The searchRadius (in)

hitPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)

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

hitElement - A reference to a com.esri.arcgis.geodatabase.ITopologyElement (out: use single element array)

Returns:

The hit

Throws:

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

AutomationException - If the ArcObject component throws an exception.

isHasPseudoNodes

boolean isHasPseudoNodes()
                  throws java.io.IOException,
                         AutomationException

Indicates if the topology graph contains pseudo nodes.

Returns:

The hasPseudoNodes

Throws:

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

AutomationException - If the ArcObject component throws an exception.

buildFromPolygon

void buildFromPolygon(IPolygon extent,
                      boolean preserveSelection)
               throws java.io.IOException,
                      AutomationException

Creates topo elements from all topology feature classes intersecting the specified polygon. The topology graph takes ownership of the input polygon.

Parameters:

extent - A reference to a com.esri.arcgis.geometry.IPolygon (in)

preserveSelection - The preserveSelection (in)

Throws:

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

AutomationException - If the ArcObject component throws an exception.

getBuildPolygonExtent

IPolygon getBuildPolygonExtent()
                        throws java.io.IOException,
                               AutomationException

The polygon used to determine the contents of the topology graph. The topology graph maintains ownership of this reference.

Returns:

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

Throws:

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

AutomationException - If the ArcObject component throws an exception.

determineNodeDegree

void determineNodeDegree()
                  throws java.io.IOException,
                         AutomationException

Nodes located outside a polygonal build extent do not have a known degree (valence). Apply this method before using the Degree or IsDegreeKnown properties of a topology node from this graph.

Throws:

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

AutomationException - If the ArcObject component throws an exception.

mergeSelectedEdges

void mergeSelectedEdges()
                 throws java.io.IOException,
                        AutomationException

Merge a connected sequence of selected edges that has the same feature parent set.

Throws:

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

AutomationException - If the ArcObject component throws an exception.