PointBuilder Class

  • PointBuilder
  • class Esri::ArcGISRuntime::PointBuilder

    The point builder allows you to create and modify point geometries incrementally. More...

    Header: #include <PointBuilder.h>
    Since: Esri::ArcGISRuntime 100.0
    Inherits: Esri::ArcGISRuntime::GeometryBuilder

    Public Functions

    PointBuilder(const Esri::ArcGISRuntime::SpatialReference &spatialReference, QObject *parent = nullptr)
    virtual ~PointBuilder() override
    double m() const
    void offsetBy(double offsetX, double offsetY)
    void setM(double m)
    void setX(double x)
    void setXY(double x, double y)
    void setY(double y)
    void setZ(double z)
    Esri::ArcGISRuntime::Point toPoint() const
    double x() const
    double y() const
    double z() const

    Reimplemented Public Functions

    virtual Esri::ArcGISRuntime::GeometryBuilderType geometryBuilderType() const override
    virtual Esri::ArcGISRuntime::Geometry toGeometry() const override

    Detailed Description

    Point geometries are immutable and cannot be changed directly once created. The PointBuilder has a number of constructors to allow you to create a new point, or you can edit an existing point using setXY(double, double) or offsetBy(double, double). Use GeometryBuilder::toGeometry to return the new Point from the builder.

    Member Function Documentation

    [explicit] PointBuilder::PointBuilder(const Esri::ArcGISRuntime::SpatialReference &spatialReference, QObject *parent = nullptr)

    Initializes a point builder from a SpatialReference.

    • spatialReference - The spatial reference to be used as the starting point for further modifications.
    • parent - An optional parent.

    [override virtual] PointBuilder::~PointBuilder()

    Destructor.

    [override virtual] Esri::ArcGISRuntime::GeometryBuilderType PointBuilder::geometryBuilderType() const

    Reimplements: GeometryBuilder::geometryBuilderType() const.

    Gets the GeometryBuilderType of this builder.

    double PointBuilder::m() const

    Gets the m-value of the point.

    See also setM().

    void PointBuilder::offsetBy(double offsetX, double offsetY)

    Offsets the point by the given offsets for the x and y dimension.

    • offsetX - The number of units to move the point on the x axis.
    • offsetY - The number of units to move the point on the y axis.

    void PointBuilder::setM(double m)

    Sets the M (measure) value of the point.

    • m - The m-value.

    See also m().

    void PointBuilder::setX(double x)

    Sets the x-coordinate of the point.

    • x - The x-coordinate.

    See also x().

    void PointBuilder::setXY(double x, double y)

    Sets the x and y coordinates of the point.

    • x - The x-coordinate.
    • y - The y-coordinate.

    void PointBuilder::setY(double y)

    Sets the y-coordinate of the point.

    • y - The y-coordinate.

    See also y().

    void PointBuilder::setZ(double z)

    Sets the z-coordinate of the point.

    • z - The z-coordinate.

    See also z().

    [override virtual] Esri::ArcGISRuntime::Geometry PointBuilder::toGeometry() const

    Reimplements: GeometryBuilder::toGeometry() const.

    Returns the point geometry this builder is constructing or modifying.

    Esri::ArcGISRuntime::Point PointBuilder::toPoint() const

    Returns the point geometry this builder is constructing or modifying.

    This is a convenience method to avoid having to cast the return value.

    double PointBuilder::x() const

    Gets the x-coordinate of the point.

    See also setX().

    double PointBuilder::y() const

    Gets the y-coordinate of the point.

    See also setY().

    double PointBuilder::z() const

    Gets the z-coordinate of the point.

    The minimum z-value is -6,356,752 meters, which is the approximate radius of the earth (the WGS 84 datum semi-minor axis). The maximum z-value is 55,000,000 meters.

    See also setZ().

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