# Class EnvelopeBuilder

Builder for creating and modifying Envelope geometries incrementally.

**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. |

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

Target | Versions |
---|---|

.NET Standard 2.0 | 100.3 - 200.4 |

.NET | 100.13 - 200.4 |

.NET Windows | 100.13 - 200.4 |

.NET Android | 200.0 - 200.4 |

.NET iOS | 200.0 - 200.4 |

.NET Framework | 100.0 - 200.4 |

Xamarin.Android | 100.0 - 100.15 |

Xamarin.iOS | 100.0 - 100.15 |

UWP | 100.0 - 200.4 |