Reticle
Allows you to edit geometries in a GeometryEditor using a GeometryEditorReticle, ideal for precise editing with snapping on a touch screen. 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 ReticleVertexTool.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 ReticleVertexTool.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.
Since
200.5.0
See also
Constructors
Creates a new ReticleVertexTool with a default GeometryEditorReticle and ReticleInteractionConfiguration By default, the ReticleVertexTool.configuration allows you to create and move individual vertices. By default, it does not allow the creation of new parts in multipart geometries. This behavior can be customized with ReticleVertexTool.configuration. For more information on how these interactions work, see ReticleInteractionConfiguration.
Properties
Defines the set of interactive operations enabled when using this tool. By default, the ReticleVertexTool.configuration allows you to create and move individual vertices. By default, it does not allow the creation of new parts in multipart geometries. You can change the values of the ReticleInteractionConfiguration 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.
Specifies the reticle visual component to be used by the ReticleVertexTool. A default GeometryEditorReticle is provided if a new one is not assigned.
Inherited properties
Defines the visual appearance of GeometryEditor geometries when this tool is in use. When a GeometryEditorTool is created, a consistent set of default symbology appropriate for that tool type is applied to its GeometryEditorTool.style property. For example, FreehandTool and ShapeTool define all vertex symbols as null by default because they use drag gestures to define entire parts of polyline and polygon geometries, whereas the VertexTool defines non-null vertex symbols because it is important to be able to see and interact with individual vertices when editing geometries with this tool.