ReticleVertexTool Class

Detailed Description

The ReticleVertexTool is recommended for precise, vertex-based geometry editing on touch devices when using the GeometryEditor. This tool can be used to create and edit Multipoint, Point, Polygon, and Polyline geometries, by adding and moving individual vertices using the reticle.

A GeometryEditorReticle is a visual aid used to indicate the edit position, displayed on a map view. By separating the point at which you interact with the screen from the point at which an edit takes place, you are able to clearly see where new vertices will be added before tapping the screen. Additionally, when snapping is enabled (SnapSettings::isEnabled), this tool allows you to see visual snapping feedback during vertex addition and moves, without fingers or a stylus hiding the screen and the snapping feedback.

A default reticle is provided, which can be customized to suit your specific app appearance, style, and accessibility requirements - for more information see GeometryEditorReticle.

Use the configuration properties to customize the possible interactions - for example, you can configure a tool specifically for moving vertices only, or for adding vertices only. For more information, and to learn more about how these interactions work, see ReticleInteractionConfiguration.

To provide the ability to move, resize, and rotate whole geometries, or parts of multipart geometries, you can change the current GeometryEditor::tool to a VertexTool instead, while keeping the current state of the GeometryEditor::geometry.

A consistent set of default symbology appropriate for for this tool type is returned from GeometryEditorTool::style. This tool takes a simpler approach to drawing the geometry than the VertexTool when there is a move in progress, by only displaying the state of the geometry elements accounting for the current move, and not displaying the existing position of any elements that will be affected by the move.

Relevant samples:

• Snap geometry edits: Use the Geometry Editor to edit a geometry and align it to existing geometries on a map.
• Create and edit geometries: Use the Geometry Editor to create new point, multipoint, polyline, or polygon geometries or to edit existing geometries by interacting with a map view.