ArcObjects Library Reference (GeoDatabase)  

IFeatureEdit Interface

Provides access to members implemented to customize feature editing. Note: the IFeatureEdit interface has been superseded byIFeatureEdit2. Please consider using the more recent version.

Product Availability

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

Members

Description
Method BeginMoveSet Prepares the set of features for a move operation.
Method DeleteSet Deletes the set of rows.
Method MoveSet Moves the set of features through a distance and direction specified by moveVector.
Method RotateSet Rotates the set of features according to the specified origin and angle.
Method Split Split the feature.
Method SplitAttributes Split the feature attributes.

Inherited Interfaces

Interfaces Description
IRowEdit Provides access to members implemented to customize object editing.

CoClasses that implement IFeatureEdit

CoClasses and Classes Description
AnnotationFeature (esriCarto) An ESRI annotation feature.
ComplexEdgeFeature ESRI Complex edge geometric network feature object.
ComplexJunctionFeature ESRI Complex junction geometric network feature.
CoverageAnnotationFeature ESRI Coverage Annotation Feature.
DimensionFeature (esriCarto) ESRI Dimension Feature class.
Feature ESRI Feature.
GeocodedFeature (esriLocation) A feature created by a locator.
NALocationFeature (esriNetworkAnalyst) A network location which can be used like a feature or a row.
NALocationRangesFeature (esriNetworkAnalyst) A container of NALocationRanges which can be used like a feature or a row.
NATraversalResultElement (esriNetworkAnalyst) An individual element in a traversal result.
RasterCatalogItem Raster Catalog Feature Class.
SchematicInMemoryFeatureLink (esriSchematic) Schematic in memory feature link object.
SchematicInMemoryFeatureNode (esriSchematic) Schematic in memory feature node object.
SchematicInMemoryFeatureNodeOnLink (esriSchematic) Schematic in memory feature node on link object.
SchematicInMemoryFeatureSubLink (esriSchematic) Schematic in memory feature sublink object.
SchematicLink (esriSchematic) A schematic link object.
SchematicNode (esriSchematic) A schematic node object.
SchematicNodeOnLink (esriSchematic) A schematic node-on-link object.
SchematicSubLink (esriSchematic) A schematic sublink object.
SimpleEdgeFeature ESRI Geometric network simple edge feature object.
SimpleJunctionFeature ESRI Geometric network simple junction feature object.
TopologyErrorFeature ESRI Topology Error Feature object.

Remarks

The IFeatureEdit interface offers specialized editing facilities on features.

The MoveSet, RotateSet, and DeleteSet methods are unusual in that they are applied to a single feature, but they operate on a whole set. There is no need to call these methods for each separate feature in the set.

In the case of simple features, you need to call this method once for every feature class contained in the set. Thus, if the selection contains ten simple features, five from class A, and five from class B, you will need to call this method on one member of the set from class A, and one member of the set from class B. When you call these methods on a feature, the method will be applied to all other features contained in the set that are also in the same feature class.

In the case of network features, it is only necessary to call these methods on one network feature found in a given geometric network. Thus, if all of the network features found in the set are contained in a single geometric network, you will only need to call these methods on one network feature. However, if there are two (or more) geometric networks represented in the network features contained in the set, then the call will need to be made two (or more) times; once for each geometric network.

In practice, it is actually quite simple to implement the appropriate calling behavior because the set that is passed in as the first argument is winnowed (that is, features contained in the set that are processed are removed from the set) and the set is automatically reset. Thus, you can effectively Next through the set and achieve the proper behavior. See the first example for an illustation of this behavior.

Split and SplitAttributes operate on single features. Split will divide polylines by points, or polygons by polylines. Other kinds of split geometries are not supported. The new features are automatically stored and the old feature deleted. SplitAttributes implements the split policy for attributes belonging to domains. It is not necessary to call SplitAttributes after using Split, this is done automatically.

An equivalent method to Split for merging features is not currently available in ArcObjects; you have to program it the long way, using ITopologicalOperator::Union, IFeature::Delete, and, if necessary, IDomain::MergePolicy.