com.esri.arcgis.geodatabase
Interface IFeatureEdit2

All Superinterfaces:
IFeatureEdit, IRowEdit, Serializable
All Known Implementing Classes:
AnnotationFeature, ComplexEdgeFeature, ComplexJunctionFeature, CoverageAnnotationFeature, DimensionFeature, Feature, IFeatureEdit2Proxy, NALocationFeature, NALocationRangesFeature, NATraversalResultElement, SchematicLink, SchematicNode, SchematicNodeOnLink, SchematicSubLink, SimpleEdgeFeature, SimpleJunctionFeature

public interface IFeatureEdit2
extends IFeatureEdit, Serializable

Provides access to members implemented to customize feature editing.

Product Availability

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


Method Summary
 ISet splitWithUpdate(IGeometry geometry)
          Split the feature by updating the split feature and creating new feature(s) for the smaller portion.
 
Methods inherited from interface com.esri.arcgis.geodatabase.IFeatureEdit
beginMoveSet, moveSet, rotateSet, split, splitAttributes
 
Methods inherited from interface com.esri.arcgis.geodatabase.IRowEdit
deleteSet
 

Method Detail

splitWithUpdate

ISet splitWithUpdate(IGeometry geometry)
                     throws IOException,
                            AutomationException
Split the feature by updating the split feature and creating new feature(s) for the smaller portion.

Remarks

SplitWithUpdate divides polylines by points or polygons by polylines, other kinds of split geometries are not supported (see IGeometry::GeometryType property for an enumeration of geometry types). Unlike the IFeatureEdit::Split method, SplitWithUpdate does not delete the original feature and insert two new features. When a feature is split, its geometry is modified and a new feature, with a new ObjectID, is inserted comprised of the remaining geometry. The geometry of the original feature will be modified to represent the largest section of the split geometry. For example, if a polyline is split at 60% along its length, the original feature's geometry will be modified to represent the 60% section and a new feature will be created with a geometry representing the remaining 40%.

You can define a policy on how the other attribute values of the new features are populated; this can be done with ArcCatalog or by using the Domain and Attribute Rule objects.

It is not necessary to call SplitAttributes after calling Split, this is done automatically.

All edits to features that participate in a Topology or Geometric Network must be performed within an edit session and bracketed within an edit operation.

Product Availability

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

Parameters:
geometry - 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.