VertexTool Class

  • VertexTool
  • class Esri::ArcGISRuntime::VertexTool

    Allows you to edit geometries in a GeometryEditor by interacting with individual vertices. More...

    Header: #include <VertexTool.h>
    Since: Esri::ArcGISRuntime 200.1
    Inherits: Esri::ArcGISRuntime::GeometryEditorTool

    Public Functions

    VertexTool(QObject *parent = nullptr)
    virtual ~VertexTool() override
    Esri::ArcGISRuntime::InteractionConfiguration *configuration() const
    void setConfiguration(Esri::ArcGISRuntime::InteractionConfiguration *configuration)

    Detailed Description

    The default GeometryEditor::tool is a VertexTool, and is suitable for creating and editing the widest range of geometry types - Multipoint, Point, Polygon, and Polyline. You create and edit these geometries by creating, selecting, and transforming individual vertices, and can also select and transform parts of Multipart (polygon and polyline) geometries. Use the configuration properties to customize the possible interactions.

    If your app targets touch screen devices, you may want to consider using the ReticleVertexTool instead.

    Relevant samples:

    • 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 FreehandTool, ShapeTool, ReticleVertexTool, and GeometryEditor::tool.

    Member Function Documentation

    [explicit] VertexTool::VertexTool(QObject *parent = nullptr)

    Creates a new VertexTool.

    • parent - The optional parent QObject.

    By default, this tool enables the creation, selection, transformation, and deletion interactions appropriate for creating and editing geometries by interacting with individual vertices. This behavior can be customized with configuration.

    [override virtual] VertexTool::~VertexTool()

    Destructor.

    Esri::ArcGISRuntime::InteractionConfiguration *VertexTool::configuration() const

    Defines the set of interactive operations enabled when using this tool.

    By default, the configuration allows you to create and select vertices by tapping on the map, and also allows you to move vertices by dragging the selected vertex.

    By default, it does not allow the creation of new parts, but does allow the selection, transformation, and deletion of any existing parts if they already exist in the GeometryEditor::geometry. Set InteractionConfiguration::isAllowPartCreation to true to allow you to tap on the view when there is no current selection (GeometryEditor::selectedElement is nullptr) to start new parts in polyline and polygon geometries.

    See also setConfiguration().

    void VertexTool::setConfiguration(Esri::ArcGISRuntime::InteractionConfiguration *configuration)

    Sets the configuration to configuration.

    See also configuration.

    Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.