IConstructMerge.MergeGeometries Method

Merges the representation from both versions of a geometry that has been modifed

[Visual Basic .NET]
Public Function MergeGeometries ( _
    ByVal pOriginal As IGeometry, _
    ByVal pEdit1 As IGeometry, _
    ByVal pEdit2 As IGeometry _
) As IGeometry

[C#]
public IGeometry MergeGeometries (
    IGeometry pOriginal,
    IGeometry pEdit1,
    IGeometry pEdit2
);

[C++]
HRESULT MergeGeometries(
  IGeometry* pOriginal,
  IGeometry* pEdit1,
  IGeometry* pEdit2,
  IGeometry** ppMerged
);

[C++]
Parameters
pOriginal 
  pOriginal is a parameter of type IGeometry
pEdit1 
  pEdit1 is a parameter of type IGeometry
pEdit2 
  pEdit2 is a parameter of type IGeometry
ppMerged [out, retval]
  ppMerged is a parameter of type IGeometry

Product Availability

Description

Constructs a new geometry by merging the two separate edits of the same original geometry. If any portion of the two edited regions or the edits themselves overlaps an error will be returned. Edited regions are the areas of the polygon or polyline where the edits took place in respect to the original geometry.  Edits are the changes reflected in the two edited geometries.
In polygons it is the area that the edit has been affected as well as the vertices and edges that participated in the edits that are important. Even if edits are on non-consecutive edges or non-consecutive vertices, if the area that one edit adds or subtracts from the polygon overlaps the second edit this will be viewed as a conflict and the geometries will not be merged.

The functionality is fully implemented for multipart features. 

Remarks

IConstructMerge pConstMrg = new GeometryEnvironmentClass() as IConstructMerge;

/*IGeometry origGeom;

IGeometry geom1;

IGeometry geom2;

...*/

IGeometry newGeom = pConstMrg.MergeGeometries(origGeom, geom1, geom2);

See Also