Allows you to edit geometries in a GeometryEditor using a GeometryEditorReticle, ideal for precise editing with snapping on a touch screen using tap driven interactions. More...
| Header | #include <Reticle |
| Since | Esri |
| Inherits | Esri |
Public Functions
| Reticle | |
| virtual | ~ |
| Esri | configuration() const |
| Esri | reticle() const |
| void | set |
| void | set |
Detailed Description
The ReticleVertexTool is recommended for a 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.
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.
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.
See also GeometryEditorReticle, ReticleInteractionConfiguration, VertexTool, FreehandTool, ShapeTool, and GeometryEditor::tool.
Member Function Documentation
[explicit] ReticleVertexTool::ReticleVertexTool (QObject *parent = nullptr)
Creates a new ReticleVertexTool with a default GeometryEditorReticle and ReticleInteractionConfiguration
- parent - The optional parent QObject.
By default, the 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 configuration. For more information on how these interactions work, see ReticleInteractionConfiguration.
[override virtual noexcept] ReticleVertexTool::~ReticleVertexTool ()
Destructor.
Esri::ArcGISRuntime::ReticleInteractionConfiguration *ReticleVertexTool::configuration() const
Defines and returns the set of interactive operations enabled when using this tool.
By default, the 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.
See also setConfiguration().
Esri::ArcGISRuntime::GeometryEditorReticle *ReticleVertexTool::reticle() const
Specifies and returns the reticle visual component to be used by the ReticleVertexTool.
A default GeometryEditorReticle is provided if a new one is not assigned.
See also setReticle().
void ReticleVertexTool::setConfiguration (Esri::ArcGISRuntime::ReticleInteractionConfiguration *configuration)
Sets the configuration to configuration.
See also configuration.
void ReticleVertexTool::setReticle (Esri::ArcGISRuntime::GeometryEditorReticle *reticle)
Sets the reticle to reticle.
See also reticle.