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

Initializes a new instance of the EnvelopeBuilder class. This method must be called on the MCT. Use QueuedTask.Run

Syntax

C#
Visual Basic (Declaration)

public EnvelopeBuilder( 
   double xMin,
   double yMin,
   double xMax,
   double yMax,
   SpatialReference spatialReference
)

Public Function New( _
   ByVal xMin As Double, _
   ByVal yMin As Double, _
   ByVal xMax As Double, _
   ByVal yMax As Double, _
   Optional ByVal spatialReference As SpatialReference _
)

Parameters

xMin: Lower left corner x value of the envelope.
yMin: Upper right corner y value of the envelope.
xMax: Lower left corner x value of the envelope.
yMax: Upper right corner y value of the envelope.
spatialReference: (Optional) The SpatialReference. The default value is null.

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.

Remarks

The resulting envelope is normalized to ensure its XMin <= XMax and YMin <= YMax. If any of the input values are NaN, then the envelope is set to empty.

Example

// Use a builder convenience method or use a builder constructor.

// Builder convenience methods don't need to run on the MCT.
Envelope envelope = EnvelopeBuilder.CreateEnvelope(100.0, 100.0, 500.0, 500.0);

// shrink the envelope by 50%
Envelope result = envelope.Expand(0.5, 0.5, true);

// Builder constructors need to run on the MCT.
ArcGIS.Desktop.Framework.Threading.Tasks.QueuedTask.Run(() =>
{
  using (EnvelopeBuilder eBuilder = new EnvelopeBuilder(100.0, 100.0, 500.0, 500.0))
  {
    // shrink by 50%
    eBuilder.Expand(0.5, 0.5, true);

    result = eBuilder.ToGeometry();
  }
});

// builderEx constructors don't need to run on the MCT.
EnvelopeBuilderEx builderEx = new EnvelopeBuilderEx(100.0, 100.0, 500.0, 500.0);
builderEx.Expand(0.5, 0.5, true);
envelope = builderEx.ToGeometry() as Envelope;

Requirements

Target Platforms: Windows 11, Windows 10, Windows 8.1

Reference

EnvelopeBuilder Class
EnvelopeBuilder Members
Overload List