Show / Hide Table of Contents

Class EnvelopeBuilder

Builder for creating and modifying Envelope geometries incrementally.

Inheritance
System.Object
GeometryBuilder<Envelope>
EnvelopeBuilder
GeometryBuilder<Envelope>.SpatialReference
GeometryBuilder<Envelope>.Extent
GeometryBuilder<Envelope>.HasM
GeometryBuilder<Envelope>.HasZ
GeometryBuilder<Envelope>.IsEmpty
GeometryBuilder<Envelope>.IsSketchValid
GeometryBuilder<Envelope>.HasCurves
GeometryBuilder<Envelope>.ReplaceGeometry(Envelope)
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.ToString()
Namespace: Esri.ArcGISRuntime.Geometry
Assembly: Esri.ArcGISRuntime.dll
Syntax
public sealed class EnvelopeBuilder : GeometryBuilder<Envelope>
Remarks

Envelope geometries are immutable and cannot be changed directly once created. Use the constructors to define minimum and maximum x,y coordinates, z and m values, and a SpatialReference. Once set, the SpatialReference cannot be changed. Use the ToGeometry() Method to get the Envelope geometry from the builder.

Constructors

Name Description
EnvelopeBuilder(Envelope)

Initializes a new instance of the EnvelopeBuilder class from an existing Envelope.

EnvelopeBuilder(MapPoint, MapPoint)

Initializes a new instance of the EnvelopeBuilder class from two diagonal corner MapPoints.

EnvelopeBuilder(MapPoint, Double, Double)

Initializes a new instance of the EnvelopeBuilder class from a center point, with a defined width and height.

EnvelopeBuilder(MapPoint, Double, Double, Double)

Initializes a new instance of the EnvelopeBuilder class from a center point, with defined width, height, and depth.

EnvelopeBuilder(SpatialReference)

Initializes a new instance of the EnvelopeBuilder class with a SpatialReference and empty geometry.

EnvelopeBuilder(Double, Double, Double, Double)

Initializes a new instance of the EnvelopeBuilder class from given diagonal x/y corner coordinates.

EnvelopeBuilder(Double, Double, Double, Double, SpatialReference)

Initializes a new instance of the EnvelopeBuilder class from given diagonal x/y corner coordinates and a SpatialReference.

Properties

Name Description
Center

Gets the center point of the builder's envelope.

Depth

Gets the depth for this builder's envelope.

Height

Gets the height of the builder's envelope.

MMax

Gets or sets the maximum M (measure) value for this builder's envelope.

MMin

Gets or sets the minimum M (measure) value for this builder's envelope.

Width

Gets the width of the builder's envelope.

XMax

Gets or sets the maximum coordinate along the x-axis (upper-right corner) for this builder's envelope.

XMin

Gets or sets the minimum coordinate along the x-axis (lower-left corner) for this builder's envelope.

YMax

Gets or sets the maximum coordinate along the y-axis (upper-right corner) for this builder's envelope.

YMin

Gets or sets the minimum coordinate along the y-axis (lower-left corner) for this builder's envelope.

ZMax

Gets or sets the maximum coordinate along the z-axis for this builder's envelope.

ZMin

Gets or sets the minimum coordinate along the z-axis for this builder's envelope.

Methods

Name Description
CenterAt(MapPoint)

Centers the envelope at the specified MapPoint.

ChangeAspectRatio(Double, Double)

Adjust the envelope's aspect ratio to match the ratio of the given width and height.

CreateWithM(Double, Double, Double, Double, Double, Double)

Creates an EnvelopeBuilder based on the given x, y, and m values.

CreateWithM(Double, Double, Double, Double, Double, Double, SpatialReference)

Creates an EnvelopeBuilder based on the given x, y, and m values in the given SpatialReference.

CreateWithM(Double, Double, Double, Double, Double, Double, Double, Double)

Creates an EnvelopeBuilder based on the given x, y, z, and m values.

CreateWithM(Double, Double, Double, Double, Double, Double, Double, Double, SpatialReference)

Creates an EnvelopeBuilder based on the given x, y, z, and m values in the given SpatialReference.

Expand(MapPoint, Double)

Scales the envelope around an anchor point by the given factor.

Expand(Double)

Scales the envelope by the given factor.

OffsetBy(Double, Double)

Moves the builder's envelope by the given offsets in the x and y dimensions.

SetM(Double, Double)

Set both M (measure) values for the builder's envelope.

SetXY(Double, Double, Double, Double)

Set the x,y coordinates for the builder's envelope.

SetZ(Double, Double)

Set both Z-values for the builder's envelope.

ToGeometry()

Returns the Geometry this geometry builder is constructing or modifying.

UnionOf(Envelope)

Finds the union of this builder's envelope and the given envelope. This builder's envelope is updated with the result.

UnionOf(MapPoint)

Finds the union of this envelope and the given MapPoint. This builder's envelope is updated with the result.

Applies to

TargetVersions
.NET Standard 2.0100.3 - 200.8
.NET100.13 - 200.8
.NET Windows100.13 - 200.8
.NET Android200.0 - 200.8
.NET iOS200.0 - 200.8
.NET Framework100.0 - 200.8
Xamarin.Android100.0 - 100.15
Xamarin.iOS100.0 - 100.15
UWP100.0 - 200.8

Relevant samples

Add graphics with symbols: Use a symbol style to display a graphic on a graphics overlay.
Buffer list: Generate multiple individual buffers or a single unioned buffer around multiple points.
Clip geometry: Clip a geometry with another geometry.
Edit and sync features: Synchronize offline edits with a feature service.
In This Article
Back to top Copyright © 2022 Esri.