Method Start

Start(Geometry)

Starts a geometry editing session based on the specified geometry.

Declaration

public void Start(Geometry initialGeometry)

Parameters

Type	Name	Description
Geometry	initialGeometry	The initial Geometry to start the editing session with.

Remarks

Use this method for data editing workflows, where you have an existing Geometry to be updated. After calling this method, the geometry is drawn in the map view, and interactions with the map view will select and edit the geometry, depending on the current Tool and its InteractionConfiguration.

When the SpatialReference of the initial geometry differs from that of the map view, the display will project the geometry to the SpatialReference of the map view, using the default DatumTransformation, for display and user interactions. Editing feature data that is reprojected on the fly can introduce spatial errors into data. When accuracy is important, best practice is to use a spatial reference for the map view which matches the feature layer geometry you are editing. The ArcGIS Pro editing help topic Introduction to projection on the fly contains further advice.

Applies to

Platforms and versions

Target	Versions
.NET Standard 2.0	200.3 - 200.8
.NET	200.3 - 200.8
.NET Windows	200.3 - 200.8
.NET Android	200.3 - 200.8
.NET iOS	200.3 - 200.8
.NET Framework	200.3 - 200.8
UWP	200.3 - 200.8

Start(GeometryType)

Starts a geometry editing session with an empty geometry of the specified GeometryType.

Declaration

public void Start(GeometryType geometryType)

Parameters

Type	Name	Description
GeometryType	geometryType	The GeometryType of geometry to edit.

Remarks

Use this method for data creation workflows, where you know the GeometryType required but do not have an existing geometry to edit. After calling this method, nothing is drawn on the map view initially - user interactions on the map view will define and edit the geometry, depending on the current Tool.

GeometryEditor can be used to create MapPoint, Multipoint, Polygon, and Polyline geometries - however FreehandTool, and ShapeTool are suitable for creating Polygon, and Polyline geometries only.

The new geometry will have the SpatialReference of the map view. You can use Project(Geometry, SpatialReference) or Project(Geometry, SpatialReference, DatumTransformation) to project the final result Geometry to a different spatial reference if required, for example when editing feature geometry. When accuracy is important, best practice is to use a spatial reference for the map view which matches the feature layer geometry you are creating. The ArcGIS Pro editing help topic Introduction to projection on the fly contains further advice.

Applies to

Platforms and versions

Target	Versions
.NET Standard 2.0	200.3 - 200.8
.NET	200.3 - 200.8
.NET Windows	200.3 - 200.8
.NET Android	200.3 - 200.8
.NET iOS	200.3 - 200.8
.NET Framework	200.3 - 200.8
UWP	200.3 - 200.8