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.5 |
.NET | 200.3 - 200.5 |
.NET Windows | 200.3 - 200.5 |
.NET Android | 200.3 - 200.5 |
.NET iOS | 200.3 - 200.5 |
.NET Framework | 200.3 - 200.5 |
UWP | 200.3 - 200.5 |
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.5 |
.NET | 200.3 - 200.5 |
.NET Windows | 200.3 - 200.5 |
.NET Android | 200.3 - 200.5 |
.NET iOS | 200.3 - 200.5 |
.NET Framework | 200.3 - 200.5 |
UWP | 200.3 - 200.5 |