ArcGISGeometryBuilder

Extent

The extent of the geometry being constructed in the geometry builder.

HasCurves

True if the geometry builder currently contains any curve segments, false otherwise.

ArcGIS software supports polygon and polyline geometries that contain curve segments (where ArcGISSegment::IsCurve is true, sometimes known as true curves or nonlinear segments). Curves may be present in certain types of data, such as Mobile Map Packages (MMPKs), or geometry JSON.

You can use curves in an ArcGISMultipartBuilder. New segment types, such as ArcGISCubicBezierSegment and ArcGISEllipticArcSegment, represent types of curve that can be added to polygon and polyline geometries.

HasM

True if the geometry builder supports geometries with m values, false otherwise.

M values are often referred to as measures, and are used in linear referencing workflows on linear datasets. NaN is a valid m value. If true, m values are stored for each vertex of the constructed geometry. Geometries with m values are created by using setters or constructors that accept an m value as a parameter.

HasZ

True if the geometry builder supports geometries with z values, false otherwise.

Z values are generally used as a z coordinate, indicating height or elevation. NaN is a valid z value. If true, z values are stored for each vertex of the constructed geometry. Geometries with z values are created by using setters or constructors that accept a z value as a parameter.

IsEmpty

True if no coordinates have been added to this geometry builder, false otherwise.

An empty geometry builder may have a valid ArcGISSpatialReference, even without coordinates.

IsSketchValid

True if the geometry builder contains sufficient points to show a valid graphical sketch, false otherwise.

This can be used as an initial lightweight check to see if the current state of a builder produces a non-empty geometry. For example, it may be used to enable or disable functionality in an editing user interface. The exact requirements vary depending on the type of geometry produced by the builder:

• An ArcGISPointBuilder must contain non-NaN x,y coordinates
• An ArcGISMultipointBuilder must contain at least one valid ArcGISPoint
• An ArcGISEnvelopeBuilder must contain non-NaN minimum and maximum x,y coordinates
• An ArcGISPolylineBuilder must contain at least one ArcGISMutablePart. Each ArcGISMutablePart it contains must have:
  • At least two valid points, or
  • At least one ArcGISSegment where ArcGISSegment::IsCurve is true
• An ArcGISPolygonBuilder must contain at least one ArcGISMutablePart. Each ArcGISMutablePart it contains must have:
  • At least three valid points, or
  • At least one ArcGISSegment where ArcGISSegment::IsCurve is true

Note that this is not equivalent to topological simplicity, which is enforced by ArcGISGeometryEngine::Simplify and checked using ArcGISGeometryEngine::IsSimple. Geometries must be topologically simple to be successfully saved in a geodatabase or used in some service operations.

It does not check the spatial reference and returns false if an error occurs.

SpatialReference

The spatial reference for the geometry.

Once set, the ArcGISSpatialReference of the geometry builder cannot be changed. Ensure that all objects added to the builder have a compatible ArcGISSpatialReference.

Create

Creates a geometry builder with the specified geometry as a starting point for further modification.

Since 1.0.0

Arguments

Returns ArcGISGeometryBuilder

A new geometry builder.

Create

Creates an empty geometry builder that builds geometries of the specified ArcGISGeometryType.

Since 1.0.0

Arguments

Returns ArcGISGeometryBuilder

A new geometry builder.

ReplaceGeometry

Replaces the geometry currently stored in the geometry builder with the new geometry.

Since 1.0.0

Arguments

Returns void

ToGeometry

Returns the geometry this geometry builder is constructing or modifying.

Since 1.0.0

Returns ArcGISGeometry

A geometry. This is passed to geometry functions.