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.

    You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

    Your ArcGIS portal

    Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

    Your ArcGIS Location Platform dashboard

    Manage billing, monitor service usage, and access additional resources.

    Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

    Close